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NAME 

as — assembler 

SYNOPSIS 

as file ... 

DESCRIPTION 

As assembles the named files, which must have the suffix ’.s’. The output 
of the assembly is left on the corresponding files with suffix ’.o’. Assem¬ 
bler listings are produced on the corresponding files with suffix ’.1st’. 

FILES 

/lib/cpp 
/lib/asm 
/usr/tmp/asm* 

/lib/symfile 
name.s 
name.o 
name.1st 

SEE ALSO 

Ulrike Weng-Beckmann. Assembler 68000 Users Guide 
Motorola, Macro Assembler Reference Manual 

DIAGNOSTICS 

Diagnostics are given in the assembler listing. 


C preprocessor 
assembler 
temporary files 

used for initialization of /lib/asm 
assembler source 
assembled module 
assembler listing 
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NAME 

bfs - big file scanner 

SYNOPSIS 

bfs [ — ] name 

DESCRIPTION 

Bfs is (almost) like ed(l) except that it is read-only and processes much 
larger files. Files can be up to 1024K bytes (the maximum possible size) 
and 32K lines, with up to 255 characters per line. Bfs is usually more 
efficient than ed for scanning a file, since the file is not copied to a 
buffer. It is most useful for identifying sections of a large file where 
csplif(l) can be used to divide it into more manageable pieces for edi¬ 
ting. 

Normally, the size of the file being scanned is printed, as is the size of 
any file written with the w command. The optional — suppresses printing 
of sizes. Input is prompted with • if P and a carriage return are typed as 
in ed. Prompting can be turned off again by inputting another P and car¬ 
riage return. Note that messages are given in response to errors if 
prompting is turned on. 

All address expressions described under ed are supported. In addition, 
regular expressions may be surrounded with two symbols besides / and ?: 
> indicates downward search without wrap-around, and < indicates 
upward search without wrap-around. Since bfs uses a different regular 
expression-matching routine from ed, the regular expressions accepted 
are slightly wider in scope (see repe*(3X)). There is a slight difference in 
mark names: only the letters a through z may be used, and all 26 marks 
. are remembered. 

The e, g, ▼, k, n, p, q, w, =, ! and null commands operate as described 

under ed. Commands such as -, ++H —, +++=. —12, and +4p are 

accepted. Note that l.lOp and 1,10 will both print the first ten lines. The 
f command only prints the name of the file being scanned; there is no 
remembered file name. The w command is independent of output diver¬ 
sion, truncation, or crunching (see the xo, xt and xc commands, below). 
The following additional commands are available: 

xi file 

Further commands are taken from the named file. When an 
end-of-file is reached, an interrupt signal is received or an 
error occurs, reading resumes with the file containing the xf. Iff 
commands may be nested to a depth of 10. 

xo [/tie] 

Further output from the p and null commands is diverted to the 
named file, which, if necessary, is created mode 666. If file is 
missing, output is diverted to the standard output. Note that 
each diversion causes truncation or creation of the file. 

: label 

This positions a label in a command file. The label is termina¬ 
ted by new-line, and blanks between the : and the start of the 
label are ignored. This command may also be used to insert 
comments into a command file, since labels need not be 
referenced. 


Page 1 


April 6, 1983 












BFS(l) 


HUNDC 


BFS(l) 


( .,. )xb/regular expression/label 

A jump (either upward or downward) is made to label if the com¬ 
mand succeeds. It fails under any of the following conditions: 

1. Either address is not between 1 and S. 

2. The second address is less than the first. 

3. The regular expression doesn’t match at least one line 
in the specified range, including the first and last lines. 

On success, . is set to the line matched and a jump is made to 
label. This command is the only one that doesn’t issue an error 
message on bad addresses, so it may be used to test whether 
addresses are bad before other commands are executed. Note 
that the command 

xb/~/ label 


is an unconditional jump. 

The xb command is allowed only if it is read from someplace, 
other than a terminal. If it is read from a pipe only a downward 
jump is possible. 


xt number 

Output from the p and null commands is truncated to at most 
number characters. The initial number is 255. 

xvfdigtf] [spaces] [value] 

The variable name is the specified digit following the xv. xv510Q 
or xvS 100 both assign the value 100 to the variable 5. 
Xvfil.lOOp assigns the value l.lOOp to the variable 6. To 
reference a variable, put a % in front of the variable name. For 
example, using the above assignments for variables 5 and 6: 


1.35p 

1,%5 

7.6 

will all print the first 100 lines. 


g/%5/p 


would globally search for the characters 100 and print each line 
containing a match. To escape the special meaning of %, a \ 
must precede it. 


g/".*\%[cds]/p 

could be used to match and list lines containing printf of 
characters, decimal integers, or strings. 

Another feature of the xv command is that the first line of out¬ 
put from a UNIX command can be stored into a variable. The 
only requirement is that the first character of value be an !. 
For example: 


-s 


•J 
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xvS!cat junk 
!rm junk 
Jecho ”X5’’ 
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xv6!expr X6 + 1 

would put the current line into variable 5, print it, and 
increment the variable 6 by one. To escape the special meaning 
of ! as the first character of value, precede it with a V 

xv7\ !date 

stores the value !date into variable 7. 
xbz label 

xbn label 

These two commands will test the last saved return code from 
the execution of a UNIX command ('.command) or nonzero value, 
respectively, to the specified label. The two examples below 
both search for the next five lines containing the string size. 

xv55 
: 1 

/size/ 

xv5!expr %5 — 1 
!if 0%5 != 0 exit 2 
xbn 1 
xv45 
: 1 

/size/ 

xv4!expr %4 — 1 
!if 0%4 = 0 exit 2 
xbz 1 

xc [surifch] 

If switch is 1, output from the p and null' commands is crun¬ 
ched; if switch is 0 it isn’t. Without an argument, xc reverses 
switch. Initially switch is set for no crunching. Crunched out¬ 
put has strings of tabs and blanks reduced to one blank and 
blank lines suppressed. 

SEE ALSO 

csplit(l), ed(l), regex(3X). 
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DIAGNOSTICS 

? for errors in commands, if prompting is turned off. 
error messages when prompting is on. 



BFS(l) 


Self-explanatory 
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NAME 

bs — a compiler/interpreter for modest-sized programs 

SYNOPSIS 

bs [ file [ args ] ] 

DESCRIPTION 

Bs is a remote descendant of Basic and Snobol4 with a little C language 
thrown in. Bs is designed for programming tasks where program 
development time is as important as the resulting speed of execution. 
Formalities of data declaration and file/process manipulation are minim¬ 
ized. Line-at-a-time debugging, the trace and dump statements, and 
useful run-time error messages all simplify program testing. Further¬ 
more, incomplete programs can be debugged; inner functions can be 
tested before outer functions have been written and vice versa. 

If the command line file argument is provided, the file is used for input 
before the console is read. By default, statements read from the file 
argument are compiled for later execution. Likewise, statements entered 1 
from the console are normally executed immediately (see compile and 
execute below). Unless the final operation is assignment, the result of an 
immediate expression statement is printed. 

Bs programs are made up of input lines. If the last character on a line is 
a \, the line is continued. Bs accepts lines of the following form: 

statement 
label statement 

A label is a name (see below) followed by a colon. A label and a variable 
can have the same name. 

A bs statement is either an expression or a keyword followed by zero or 
more expressions. Some keywords {clear, compile, /, execute, include, 
those, obase, and run) are always executed as they are compiled. 

Statement Syntax: 
expression 

The expression is executed for its side effects (value, assignment or 
function call). The details of expressions follow the description of sta¬ 
tement types below. 

break 

Break exits from the inner-most for /while loop, 
clear 

Clears the symbol table and compiled statements. Clear is executed 
immediately. 

compile [ expression ] 

Succeeding statements are compiled (overrides the immediate execu¬ 
tion default). The optional expression is evaluated and used as a file 
name for further input. A clear is associated with this latter case. 
Compile is executed immediately. 

continue 

Continue transfers to the loop-continuation of the current for /while 
loop. 
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dump 

The name and current value of every non-local variable is printed. 
After an error or interrupt, the number of the last statement and 
(possibly) the user-function trace are displayed. 

exit [ expression ] 

Return to system level. The expression is returned as process status, 
execute 

Change to immediate execution mode (an interrupt has a similar 
effect). This statement does not cause stored statements to execute 
(see run below). 

for name = expression expression statement 
for name = expression expression 

next 

for expression , expression , expression statement 
for expression . expression , expression 

next 

The for statement repetitively executes a statement (first form) or a 
group of statements (second form) under control of a named variable. 
The variable takes on the value of the first expression, then is 
incremented by one on each loop, not to exceed the value of the 
second expression. The third and fourth forms require three expres¬ 
sions separated by commas. The first of these is the initialization, the 
second is the test (true to continue), and the third is the loop- 
continuation action (normally an increment). 

fun f([a,... ]) (v,... ] 


nuf 

Fun defines the function name, arguments, and local variables for a 
user-written function. Up to ten arguments and local variables are 
allowed. Such names cannot be arrays, nor can they be I/O associ¬ 
ated. Function definitions may not be nested. 

fretura 

A way to signal the failure of a user-written function. See the interro¬ 
gation operator (?) below. If interrogation is not present, /return 
merely returns zero. When interrogation is active, /return transfers 
to that expression (possibly by-passing intermediate function 
returns). 

ibase N 

Jbase sets the input base (radix) to N. The only supported values for 
N are 8, 10 (the default), and 16. Hexadecimal values 1.0—15 are 
entered as a—f. A leading digit is required (i.e., fOa must be entered as 
OfOa). Jbase (and abase, below) are executed immediately. 

goto name 

Control is passed to the internally stored statement with the matching 
label. 
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if expression statement 
if expression 

[ else 

... ] 

fi 

The statement (first form) or group of statements (second form) is 
executed if the expression evaluates to non-zero. The strings 0 and 
(null) evaluate as zero. In the second form, an optional else allows for 
a group of statements to be executed when the first group is not. The 
only statement permitted on the same line with an else is an if ; only 
other fi' s can be on the same line with a fi. The elision of else and if 
into an elif is supported. Only a single fi is required to close an if ... 
elif...[ else ... ] sequence. 

include expression 

The expression must evaluate to a file name. The file must contain 6s 
Such statements become part of the program being compiled, source 
statements. Include statements may not be nested. 

obase N 

Obase sets the input base to N (see ibase above). 

onintr label 
onintr 

The onintr command provides program control of interrupts. In the 
first form, control will pass to the label given, just as if a goto had 
been executed at the time oninfr was executed. The effect of the sta¬ 
tement is cleared after each interrupt. In the second form, an inter¬ 
rupt will cause 6s to terminate. 

return [expression] 

The expression is evaluated and the result is passed back as the value 
of a function call. If no expression is given, zero is returned. 

run ~ 

The random number generator is reset. Control is passed to the first 
internal statement. If the run statement is contained in a file, it 
should be the last statement. 

stop 

Execution of internal statements is stopped. Bs reverts to immediate 
mode. 

trace [ expression ] 

The trace statement controls function tracing. If the expression is 
null (or evaluates to zero), tracing is turned off. Otherwise, a record 
of user-function calls/retums will be printed. Each return 
decrements the trace expression value. 

while expression statement 
while expression 

next 

While is similar to for except that only the conditional expression for 
loop-continuation is given. 
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! shell command 

An immediate escape to the Shell. 


# 


• • • 

This statement is ignored, 
gram. 


It is used to interject commentary in a pro- 


Expression Syntax: 


name 

A name is used to specify a variable. Names are composed of a letter 
(upper or lower case) optionally followed by letters and digits. Only 
the first six characters of a name are significant. Except for names 
declared in fun statements, all names are global to the program. 
Names can take on numeric (double float) values, string values, or can 
be associated with input/output (see the built-in function open() 
below). 

name ( [expression [ , expression] ..'.]) 

Functions can be called by a name followed by the arguments in 
parentheses separated by commas. Except for built-in functions 
(listed below), the name must be defined with a fun statement. 
Arguments to functions are passed by value. 

name [ expression [ , expression ] ... ] 

This syntax is used reference either arrays or tables (see built-in table 
functions below). For arrays, each expression is truncated to an 
integer and used as a specifier for the name. The resulting array 
reference is syntactically identical to a name; a[l,2] is the same as 
a[l][2]. The truncated expressions are restricted to values between 0 
and 32767. 

number 

A number is used to represent a constant value. - A number is written 
in Fortran style, and contains digits, an optional decimal point, and 
possibly a scale factor consisting of an e followed by a possibly signed 
exponent. 

string 

Character strings are delimited by " characters. The \ escape 
character allows the double quote (\"). new-line (\n), carriage return 
(\r), backspace (\b). and tab (\t) characters to appear in a string. 
Otherwise, \ stands for itself. 

( expression ) 

Parentheses are used to alter the normal order of evaluation. 

( expression, expression [, expression ...])[ expression ] 

The bracketed expression is used as a subscript to select a comma- 
separated expression from the parenthesized list. List elements are 
numbered from the left, starting at zero. The expression: 

( False, True )[ a == b ] 

has the value True if the comparison is true. 

? expression 

The interrogation operator tests for the success of the expression 
rather than its value. At the moment, it is useful for testing end-of- 


0 


J 


April 6, 1983 


Page 4 





BS( 1) 


MUNIX 


BS( 1) 


file (see examples in the Programming Tips section below), the result 
of the eval built-in function, and for checking the return from user- 
written functions (see /return). An interrogation "trap” (end-of-file, 
etc.) causes an immediate transfer to the most recent interrogation, 
possibly skipping assignment statements or intervening function 
levels. 

— expression 

The result is the negation of the expression. 

++ name 

Increments the value of the variable (or array reference). The result 
is the new value. 

— name 

Decrements the value of the variable. The result is the new value. 

! expression 

The logical negation of the expression. Watch out for the shell escape 
command. 

expression operator expression 

Common functions of two arguments are abbreviated by the two 
arguments separated by an operator denoting the function. Except 
for the assignment, concatenation, and relational operators, both 
operands are converted to numeric form before the function is 
applied. 

Binary Operators (in increasing precedence): 

= is the assignment operator. The left operand must be a name or an 
array element. The result is the right operand. Assignment binds 
right to left, all other operators bind left to right. 

_(underscore) is the concatenation operator. 

Ik (logical and) has result zero if either of its arguments are zero. It 
has result one if both of its arguments are non-zero; | (logical or) has 
result zero if both of its arguments are zero. It has result one if either 
of its arguments is non-zero. Both operators treat a null string as a 
zero. 

<= > >= == != 

The relational operators (< less than, <= less than or equal, > greater 
than, >= greater than or equal, == equal to, != not equal to) return 
one if their arguments are in the specified relation. They return zero 
otherwise. Relational operators at the same level extend as follows: 
a>6>c is the same as a>6 <Jr 6>c. A string comparison is made if both 
operands are strings. 

Add and subtract. 

/ % 

Multiply, divide, and remainder. 
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Exponentiation. 

Built-in Functions: 

Dealing with arguments 

arg(i) 

is the value of the t-th actual parameter on the current level of func¬ 
tion call. At level zero, arg returns the i-th command-line argument 
(ary(O) returns bs). 

narg() 

returns the number of arguments passed. At level zero, the command 
argument count is returned. 

Mathematical 

abs(x) 

is the absolute value of x. 
atan(x) 

is the arctangent of x. Its value is between — n/2 and tt/ 2. 
ceil(x) 

returns the smallest integer not less than x. 
cos(x) 

is the cosine of x (radians). 
exp(x) 

• is the exponential function of x. . 
floor(x) 

returns the largest integer not greater than x. 
log(x) 

is the natural logarithm of x. 
rand() 

is a uniformly distributed random number between zero and one. 
sin(x) 

is the sine of x (radians). 
sqrt(x) 

is the square root of x. 

String operations 

size(s) 

the size (length in bytes) of s is returned. 
format(f, a) 

returns the formatted value of a. F is assumed to be a format 
specification in the style of print 3S). Only the and 

X...3 types are safe. 

index(x, y) 

returns the number of the first position in x that any of the charac¬ 
ters from y matches. No match yields zero. 

trans(s, f, t) 

Translates characters of the source s from matching characters in / 
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to a character in the same position in t. Source characters that do 
not appear in / are copied to the result. If the string / is longer than 
t, source characters that match in the excess portion of f do not 
appear in the result. 

substr(s, start, width) 

returns the sub-string of s defined by the start ing position and width. 

match(string, pattern) 
mstring(n) 

The pattern is similar to the regular expression syntax of the ed(l) 
command. The characters [, ], >»> (inside brackets), • and S are 
special. The mstring function returns the n-th (1 <= n <= 10) sub¬ 
string of the subject that occurred between pairs of the pattern sym¬ 
bols \( and \) for the most recent call to match. To succeed, pat¬ 
terns must match the beginning of the string (as if all patterns began 
with **). The function returns the number of characters matched. 
For example: 

match("a I23ab 123", ".*\ ([a-z]\)") == 6 
mstring(l) == "b" 

File handling 

open(name, file, function) 
close(name) 

The name argument must be a 6s variable name (passed as a string). 
For the open, the file argument may be 1) a 0 (zero), 1, or 2 represen¬ 
ting standard input, output, or error output, respectively, 2) a string 
representing a file name, or 3) a string beginning with an ! represen¬ 
ting a command to be executed (via sh —c). The function argument 
must be either r (read), w (write), W (write without new-line), or a 
(append). After a close, the name reverts to being an ordinary varia¬ 
ble. The initial associations are: 

open("get", 0, "r") 
openC'put", 1, ”w") 
open("puterr", 2, "w") 

Examples are given in the following section. 

access(s, m) 

executes access(2). 

ftype(s) 

returns a single character file type indication: f for regular file, d for 
directory, b for block special, or c for character special. 

Tables 

table(name. size) 

A table in 6s is an associatively accessed, single-dimension array. 
"Subscripts” (called keys) are strings (numbers are converted). The 
name argument must be a 6s variable name (passed as a string). The 
size argument sets the minimum number of elements to be allocated. 
Bs prints an error message and stops on table overflow. 

item(name, i) 
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key() 

The item function accesses table elements sequentially (in normal 
use, there is no orderly progression of key values). Where the item 
function accesses values, the key function accesses the “subscript" of 
the previous item call. The name argument should not be quoted. 
Since exact table sizes are not defined, the interrogation operator 
should be used to detect end-of-table, for example: 

table("t'\ 100) 


# If word contains "party”, the following expression adds one to 
the count 

# of that word: 

++t[word] 


# To print out the the key/value pairs: 

for i = 0, ?(s = item(t, i)). ++i if key() put = key()_":"_s 


iskey(name, word ) 

The iskey function tests whether the key word exists in the table 
name and returns one for true, zero for false. 


Odds and ends 


eval(s) 

The string argument is evaluated as a 6s expression. The function is 
handy for converting numeric strings to numeric internal form. Eval 
can also be used as a crude form of indirection, as in: 


name = "xyz" 
eval("++”_ name) 

which increments the variable xyz. In addition, eval preceded by the 
interrogation operator permits the user to control 6s error condi¬ 
tions. For example: 

?eval(”open(\ "X\ ", \ #, XXX\ ", \ "r\ ")") 


returns the value zero if there is no file named "XXX” (instead of hal¬ 
ting the user's program). The following executes a goto to the label L 
(if it exists): 


label="L" 

if !(?eval("goto label)) puterr » "no label” 
plot(request, args) 

Thepioi function produces output on devices recognized by fplof(lG). 
The requests are as follows: 

Call Function 


plot(0, term) causes further plot output to be piped 

into fplof(lG) with an argument of 
—T term. 


plot(l) 

plot(2, string) 
plot(3, xl. yl, x2, y2) 


"erases” the plotter. 

labels the current point with string. 

draws the line between ( xl.yl) and 
( x2,y2). 
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r-s 


plot(4, x, y, r) draws a circle with center (x.y) and 

radius r. 


plot(5, xl, yl, x2, y2, x3, y3) 

draws an arc (counterclockwise) with 
center (xl,yl) and endpoints ( x2,y2 ) 
and ( x3,y3 ). 


plot(6) 
plot(7, x, y) 
plot(8, x, y) 

plot(9, x, y) 


is not implemented. 

makes the current point ( x,y ). 

draws a line from the current point to 

draws a point at (x,y). 


plot(10, string) sets the line mode to string. 

plot(ll, xl, yl, x2, y2) makes ( xl.yl ) the lower left corner of 

the plotting area and ( x2,y2) the upper 
right corner of the plotting area. 


plot(l2, xl, yl, x2, y2) causes subsequent x (y) coordinates to 

be multiplied by xl (yl) and then added 
to x2 (y2) before they are plotted. The 
initial scaling is plot(l2, 1.0, 1.0, 0.0, 
0 . 0 ). 

Some requests do not apply to all plotters. All requests except zero 
and twelve are implemented by. piping characters to <p£of(lG). See 
plot (5) formore details. 


last() 

in immediate mode, last returns the most recently computed value. 


PROGRAMMING TIPS 

Using bs as a calculator: 



S bs 

# Distance (inches) light travels in a nanosecond. 

186000 * 5280 • 12 / le9 

11.78496 


# Compound interest (6% for 5 years on 81,000). 
int = .06 / 4 

bal = 1000 

for i = 1 5*4 bal = bal + balrint 

bal - 1000 

346.855007 

exit 

The outline of a typical bs program: 

# initialize things: 
varl = 1 

open("read", "infile", "r") 
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§ compute: 
while ?(str = read) 


next 

# clean up: 
close("read") 


§ last statement executed (exit or stop): 
exit 

# last input line: 
run 

Input/Output examples: 

# Copy "oidfile" to "newfile". 
open("read”, "oidfile". V) 
open("wite'\ "newfile", "w") 

while ?(write = read) 

# close "read” and "write": 
close(”read”) 
close("write") 


f Pipe between commands. 
open("ls", "Us •**, "r") 
open("pr", "!pr -2 -h 'List"*, "w") 
while ?(pr = Is) ... 


# be sure to close (went for) these: 

close("ls") 

close(”pr") 


SEE ALSO 

ed(l), sh(l), tplot(lG), access(2), printf(3S), stdio(3S), Section 3 of this 
volume for further description of the mathematical functions (pow(3M) is 
used for exponentiation), plot(5). Bs uses the Standard Input/Output 


package. 
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NAME 

cc, lcc — C compiler 
SYNOPSIS 

cc [ option ] ... file ... 

DESCRIPTION 

Cc is the UNIX C compiler. It accepts several types of arguments: 

Arguments whose names end with \c’ are taken to be C source programs: 
they are compiled, and each object program is left on the file whose 
name is that of the source with ‘.o' substituted for \c‘. The ‘.o’ file is nor¬ 
mally deleted, however, if a single C program is compiled and linked all at 
one go. This C-compiler has the identifier "m68000" predefined, such 
that “jjfifdef m68000" is true. 

A call "cc test.c" is the same as "cc -c test.c &Se Id /lib/crtO.o test.o -lc 
ScSc rm test.o". The call "cc *. 0 " is the same as "Id /lib/crtO.o *.o -lc". If 
your directory contains the file xyz.c, a call "make xyz" will result in “cc 
-o xyz xyz.c". 

The following options are interpreted by cc. See ld( l) for link-time 
options. 

-c Suppress the linking phase of the compilation, and force an 
object file to be produced even if only one program is compiled. 

—o output 

Name the final output file output. If this option is used the file 
‘a.out* will be left undisturbed. This option is passed on to the 
linker. 

This option must be given, if your program includes floating point 
operations. The library libffp.a will be searched before libc.a. 

Compile the named C programs, and produce an assembly listing 
on corresponding files suffixed '.s’. This .option is used mainly for 
compiler debugging. 

This option, followed by a number, e.g. 1234 (decimal), 01234 
(octal) or 0x1234 (hex), together with option —S starts the pro¬ 
gram counter in the produced assembly-listing with the given 
number. 

Arrange for the compiler to produce code which puts the current 
linenumber into the stackframe during execution. The C- 
stacktrace of adb(l) (command Sc or SC) will then give you for 
each active procedure the current linenumber. 

Adds entries to the symbol table of the produced .0 module which 
indicate line numbers and corresponding code location. Used by 
the pbug source oriented debugger. 

Arrange for the compiler to produce code which counts the num¬ 
ber of times each routine is called; also, if linking takes place, 
replace the standard startup routine by one which automatically 
calls montfor(3) at the start and arranges to write out a mon.out 
file at normal termination of execution of the object program. An 
execution profile can then be generated by use of praf{ 1). 
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-T 


—u 


-2 


-8 


-P 


-E 


With this option initialized data is put into the text- rather than 
the data segment. Thus for programs like the shell, whose text 
segments are shared between many users, memory space can be 
saved. Apply this option only to modules with nothing but con¬ 
stant data declarations. 

All characters will be treated as "unsigned char". 

Changes the integer size from 2 (default) to 4. This makes pro¬ 
grams which neglect the differences between int and pointer or 
int and long much more portable. On the other hand, the produ¬ 
ced code is less efficient. When the name lcc is linked to cc, lee is 
equivalent to cc -4. This option is also passed to the linker. 

Like option -4. However, short parameters remain short and char 
parameters are only converted to short, not int, before they are 
pushed on the stack. This option is used for example to compile 
the system calls in the 4-byte-integer standard library 
/lib/libLc.A, which must interface to a 2-byte-integer world. 

Currently, only the Motorola Fast Floating Point Package is 
available for floating point simulation. This package does not 
implement 64-bit floating point. Therefore, double is considered 
to be the same as float by default. Option -8 changes the default 
such that sizeof(double) = 8. The code generator will then pro¬ 
duce calls to procedures dadd, dmul etc. for double addition and 
multiplication, which are not yet implemented. 

Run only the macro preprocessor and place the result for each 
*.c’ file in a corresponding \i’ file that has no lines in it. 

Run only the macro preprocessor and send the result to the stan¬ 
dard output. The output is intended for compiler debugging; it is 
unacceptable as input to cc. 


—Dname -def 
-Dnomt 

Define the name to the preprocessor, as if by ’^define’. If no 
definition is given, the name is defined as 1. 


—U name 


Remove any initial definition of name. 


-I dir ‘^include’ files whose names do not begin with V are always 
sought first in the directory of the file argument, then in direc¬ 
tories named in —I options, then in directories on a standard list. 


—Bstring 

Find substitute compiler passes in the files named string with the 
suffixes cpp, cO, cl and c2. If string is empty, use a standard 
backup version. 

—t[p0l2] 

Find only the designated compiler passes in the files whose names 
are constructed by a --B option. In the absence of a -B option, 
the string is taken to be '/usr/src/cmd/c/'. 

Other arguments are taken to be either linker option arguments, or C- 
compatible object programs, typically produced by an earlier cc run, or 
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perhaps libraries of C-compatible routines. These programs, together 
with the results of any compilations specified, are linked (in the order 
given) to produce an executable program with name a.out. 

FILES 

file.c 
file.o 
a.out 

/tmp/ctm? 

/lib/cpp 
/lib/c[0l2] 

/usr/c/oc[0l2] 

/usr/c/ocpp 
/lib/crtO.o 
/lib/mcrtO.o 
/lib/libc.a 
/lib/libffp.a 
/usr/include 

SEE ALSO 

B. W. Kemighan and D. M. Ritchie, The C Programming Language, 

Prentice-Hall, 1978 

D. M. Ritchie, CReference Manual 

monitor(3), prof(l), adb(l), ld(l) 

DIAGNOSTICS 

The diagnostics produced by C itself are intended to be self-explanatory. 
Occasional messages may be produced by the linker. 

BUGS 

Option -g should also be usable by adb, so that breakpoints could be set 
to the start of a line. 


input file 

object file 

linked output 

temporaries for cc 

preprocessor 

compiler passes for cc 

backup compiler passes for cc 

backup preprocessor 

runtime initialization 

runtime initialization for profiling 

standard library, see intro (3) 

library with floating point routines 

standard directory for *#include’ files 
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NAME 

cpio — copy file archives in and out 

SYNOPSIS 

cpio —o [ acBvS ] 

cpio —i [ Bcdmrtuvs6S ] [ patterns ] 
cpio —p [ adlmruv ] directory 

DESCRIPTION 

Cpio — o (copy out) reads the standard input to obtain a list of path 
names and copies those files onto the standard output together with 
path name and status information. 

Cpio —i (copy in) extracts from the standard input (which is assumed to 
be the product of a previous cpio — o) the names of files selected by zero 
or more patterns given in the name-generating notation of s/i(l). In pat¬ 
terns, meta-characters ?, •. and [...] match the slash / character. The^ 
default for patterns is • (i.e., select all files). 

Cpio — p (pass) copies out and in in a single operation. Destination path 
names are interpreted relative to the named directory. 

The meanings of the available options are: 

a Reset access times of input files after they have been copied. 

B Input/output is to be blocked 5,120 bytes to the record (does not 
apply to the pass option: meaningful only with data directed to or 
from /dev/rmt?). 

d Directories are to be created as needed. 

c Write header information in ASCII character form for portability, 
r Interactively rename files. If the user types a null line, the file is 
skipped. 

t Print a table of contents of the input. No files -are created, 

u Copy unconditionally (normally, an older file will not replace a 

newer file with the same name). 

▼ Verbose: causes a list of file names to be printed. When used with 

the t option, the table of contents looks like the output of an Is —1 
command (see is(l)). 

1 Whenever possible, link files rather than copying them. Usable 
only with the —p option. 

m Retain previous file modification time. This option is ineffective on 
directories that are being copied. 

s For transfer of a tape in cpio format between a PDP 11 and the 
QU68000. (The bytes are swapped except of the header informa¬ 
tion.) 

6 Process an old (i.e., UNIX Sixth Edition format) file. Only useful 
with —i (copy in). 

S set the blocking factor to 120 (speeds up I/O from resp. to the 
streamer. 

EXAMPLES 

The first example below copies the contents of a directory into an 
archive: the second duplicates a directory hierarchy: 

Is | cpio —o >/dev/mt0 
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cd olddir 

find . —print | cpio —pdl nevrdir 

The trivial case "find . —print | cpio —oB >/dev/rmtO’' can be handled 
more efficiently by: 

find . —cpio /dev/rmtO 

SEE ALSO 

ar(l), find(l), cpio(5). 

BUGS 

Path names are restricted to 128 characters. If there are too many uni¬ 
que linked files, the program runs out of memory to keep track of them 
and, thereafter, linking information is lost. Only the super-user can copy 
special files. 
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NAME 

create — create a file 

SYNOPSIS 

create file... 

DESCRIPTION 

Create creates one or more files named file... with a length of 0 bytes. 
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NAUE 

cref — make cross-reference listing 
SYNOPSIS 

cref [ —acilnostuxl23 ] files 
DESCRIPTION 

Cref makes a cross-reference listing of assembler or C programs; files 
are searched for symbols in the appropriate syntax. 

The output report is in four columns: 

1. symbol; 

2. file name; 

3. see below; 

4. text as it appears in the file. 

Cref uses either an ignore file or an only file. If the —i option is given, 
the next argument is taken to be an ignore file; if the -o option is given, 
the next argument is taken to be an only file. Ignore and only files are 
lists of symbols separated by new-lines. All symbols in an ignore file are 
ignored in columns 1 and 3 of the output. If an only file is given, only 
symbols in that file will appear in column 1. Only one of these options 
may be given; the default setting is —i using the default ignore file (see 
FILES below). Assembler pre-defined symbols or C keywords are ignored. 

The —s option causes current symbols to be put in column 3. In the 
assembler, the current symbol is the most recent name symbol; in C, the 
current function name. The —1 option causes the line number within the 
file to be put in column 3. 

The —t option causes the next available argument to be used as the name 
of the intermediate file (instead of the temporary file /tmp/crt??). This 
file is created and is not removed at the end of the process. 

The cref options are: 

a assembler format (default) 
c C format input 
i use an ignore file (see above) 

1 put line number in column 3 (instead of current symbol) 
n omit column 4 (no context) 
o use an only file (see above) 
s current symbol in column 3 (default) 
t user-supplied temporary file 
u print only symbols that occur exactly once 
x print only C external symbols 

1 sort output on column 1 (default) 

2 sort output on column 2 

3 sort output on column 3. 

FILES 

/tmp/crt?? temporaries 
/usr/lib/cref/aign 

default assembler ignore file 
/usr/lib/cref/atab 

grammar table for assembler files 
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/usr/lib/cref / cign 

default C ignore file 
/usr/lib / cref / ctab 

grammar table for C files 
/ usr /lib/cref/crpost 

post-processor 
/usr/lib / cref /upost 

post-processor for —u option 

SEE ALSO 

as(l), cc(l), sort(l), xref(l). 

BUGS 

Cref inserts an ASCII DEL character into the intermediate file after the 
eighth character of each name that is eight or more characters long in 
the source file. 
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NAME 

csplit — context split 
SYNOPSIS 

csplit [—s] [—k] [—f prefix] file argl [... argn] 

DESCRIPTION 

Csplit reads file and separates it into n+1 sections, defined by the 
arguments argl... argn. By default the sections are placed in xxOO .. . 
xxn (n may not be greater than 99). These sections get the following 
pieces of file: 

00: From the start of file up to (but not including) the line 
referenced by argl. 

01: From the line referenced by argl up to the line referenced by 
a rg2. 

n+1: From the line referenced by argn to the end of file. 

The options to csplit are: 

Csplit normally prints the character counts for each file 
created. If the —s option is present, csplit suppresses the 
printing of all character counts. 

Csplit normally removes created files if an error occurs. 
If the —k option is present, csplit leaves previously 
created files intact. 

—f prefix If the —f option is used, the created files are named 
prefix 00 .. . prefixn. The default is xxOO ... xxn. 

The arguments {argl ... argn) to csplit can be a combination of the fol¬ 
lowing: 

/rexp / 

A file is to be created for the section from the current line 
up to (but not including) the line containing the regular 
expression rexp. The current line becomes the line con¬ 
taining rexp. This argument may be followed by an optional 
+or — some number of lines (e.g., /Page/—5). 

%rexp% 

This argument is the same as /rexp/, except that no file is 
created for the section. 

Inno A file is to be created from the current line up to (but not 
including) Inno. The current line becomes Inno. 

\num\ Repeat argument. This argument may follow any of the 
above arguments. If it follows a rexp type argument, that 
argument is applied num more times. If it follows Inno, the 
file will be split every Inno lines {num times) from that 
point. 

Enclose all rexp type arguments that contain blanks or other characters 
meaningful to the Shell in the appropriate quotes. Regular expressions 
may not contain embedded new-lines. Csplit does not affect the original 
file; it is the users responsibility to remove it. 
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EXAMPLES 

csplit —f cobol file ’/procedure division/' /par5./ /parl6./ 

This example creates four files, cobolOO ... cobol03. After editing the 
"split” files, they can be recombined as follows: 


cat cobol0[0—3] > file 

Note that this example overwrites the original file, 
csplit—k file 100 (99j 

This example would split the file at every 100 lines, up to 10,000 lines. 
The —k option causes the created files to be retained if there are less 
than 10.000 lines; however, an error message would still be printed. 



csplit —k prog.c ’%main(/5' */~j/+1' {20j 

Assuming that prog.c follows the normal C coding convention of ending 
routines with a { at the beginning of the line, this example will create a 
file containing each separate C routine (up to 21) in prog.c. 


SEE ALSO 

ed(l), sh(l), regexp(7). 

DIAGNOSTICS 

Self explanatory except for: 

arg — out of range 

which means that the given argument did not reference a line between 
the current position and the end of the file. 
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NAME 

devnm — device name 
SYNOPSIS 

/etc/devnm [ names ] 

DESCRIPTION 

Devnm identifies the special file associated with the mounted file system 
where the argument name resides. 

This command is most commonly used by /etc/rc (see rc(8)) to con¬ 
struct a mount table entry for the root device. 

EXAMPLE 

The command: 

/etc/devnm /usr * 
produces 

rpl /usr 

if /usr is mounted on /dev/rpl. 

FILES 

/dev/rp* 

/etc/mtab 

SEE ALSO 

setmnt(lM). 
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NAME 

dump — incremental file system dump 
SYNOPSIS 

dump [ key [ argument ... ] filesystem ] 

DESCRIPTION 

Dump copies to magnetic tape all files changed after a certain date in 
the filesystem. The key specifies the date and other options about the 
dump. Key consists of characters from the set 0123456789fubsd. 

f Place the dump on the next argument file instead of the tape. 

u If the dump completes successfully, write the date of the beginning 
of the dump on file '/etc/ddate*. This file records a separate date 
for each filesystem and each dump level. 

0-9 This number is the 'dump level*. All files modified since the last date 
stored in the file '/etc/ddate' for the same filesystem at lesser levels 
will be dumped. If no date is determined by the level, the beginning 
of time is assumed; thus the option 0 causes the entire filesystem to 
be dumped. 

b The size of the dump device is specified in number of blocks. The 
number is taken from the next argument. This option is useful when 
you dump to floppy disks. When the specified number of blocks is 
reached, the dump will wait for additional floppies. 

s The size of the dump tape is specified in feet. The number of feet is 
taken from the next argument. When the specified size is reached, 
the dump will wait for reels to be changed. The default size is 2300 
feet. 

d The density of the tape, expressed in BPI, is taken from the next 
argument. This is used in calculating the amount of tape used per 
write. The default is 1600. 

If no arguments are given, the key is assumed to be 9u and a default file 
system is dumped to the default tape. 

Now a short suggestion on how perform dumps. Start with a full level 0 
dump 

dump Ou 

Next, period,c level 9 dumps should be made on an exponential progres* 
sion of tapes. (Sometimes called Tower of Hanoi -12131214... tape 
1 used every other time, tape 2 used every fourth, tape 3 used every 
eighth, etc.) 

dump 9u 

When the level 9 incremental approaches a full tape (about 78000 blocks 
at 1600 BPI blocked 20), a level 1 dump should be made. 

dump lu 

After this, the exponential series should progress as uninterrupted. 
These level 9 dumps are based on the level 1 dump which is based on the 
level 0 full dump. This progression of levels of dump can be carried as 
far as desired. 
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FILES 

default filesystem and tape vary with installation. 

/etc/ddate: record dump dates of filesystem/level. 

SEE ALSO 

restor(l). dump(5), dumpdir(l) 

DIAGNOSTICS 

If the dump requires more than one tape, it will ask you to change tapes. 
Reply with a new-line when this has been done. 

BUGS 

Sizes are based on 1600 BPI blocked tape. The raw magtape device has 
to be used to approach these densities. Read errors on the filesystem 
are ignored. Write errors on the magtape are usually fatal. 
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NAME 

ed — text editor 
SYNOPSIS 

ed [ - ] [ -x ] [ file ] 

DESCRIPTION 

Ed is the standard text editor. If the file argument is given, ed simulates 
an e command (see below) on the named file; that is to say, the file is 
read into ed' s buffer so that it can be edited. The optional — suppresses 
the printing of character counts by e, r, and w commands, of diagnostics 
from e and q commands, and of the ! prompt after a Ishell command. If 
—x is present, an x command is simulated first to handle an encrypted 
file. Ed operates on a copy of the file it is editing; changes made to the 
copy have no effect on the file until a w (write) command is given. The 
copy of the text being edited resides in a temporary file called the buffer. 
There is only one buffer. 

Commands to ed have a simple and regular structure: zero, one, or two 
addresses followed by a single-character command, possibly followed by 
parameters to that command. These addresses specify one or more lines 
in the buffer. Every command that requires addresses has default 
addresses, so that the addresses can very often be omitted. 

In general, only one command may appear on a line. Certain commands 
allow the input of text. This text is placed in the appropriate place in the 
buffer. While ed is accepting text, it is said to be in input mode. In this 
mode, no commands are recognized; all input is merely collected. Input 
mode is left by typing a period (.) alone at the beginning of a line. 

Ed supports a limited form of regular expression notation; regular 
expressions are used in addresses to specify lines and in some commands 
(e.g., s) to specify portions of a line that are to be substituted. A regular 
expression (RE) specifies a set of character strings. A member of this set 
of strings is said to be matched by the RE. The REs allowed by ed are 
constructed as follows: 

The following one-character REs match a single character: 

1.1 An ordinary character ( not one of those discussed in 1.2 below) is a 
one-character RE that matches itself. 

1.2 A backslash (\) followed by any special character is a one- 
character RE that matches the special character itself. The special 
characters are: 

a. ., ♦, [, and \ (period, asterisk, left square bracket, and 
backslash, respectively), which are always special, except when 
they appear within square brackets ([]; see 1.4 below). 

b. (caret or circumflex), which is special at the beginning of an 
entire RE (see 3.1 and 3.2 below), or when it immediately follows 
the left of a pair of square brackets ([]) (see 1.4 below). 

c. S (currency symbol), which is special at the end of an entire RE 
(see 3.2 below). 

d. The character used to bound (i.e., delimit) an entire RE, which 
is special for that RE (for example, see how slash (/) is used in 
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the g command, below.) 

1.3 A period (.) is a one-character RE that matches any character 
except new-line. 

1.4 A non-empty string of characters enclosed in square brackets 
([]) is a one-character RE that matches any one character in 
that string. If, however, the first character of the string is a 
circumflex (—), the one-character RE matches any character 
except new-line and the remaining characters in the string. 
The has this special meaning only if it occurs first in the 
string. The minus (—) may be used to indicate a range of con¬ 
secutive ASCII characters; for example, [0—9] is equivalent to 
[0123456789]. The — loses this special meaning if it occurs 
first (after an initial if any) or last in the string. The right 
square bracket (]) does not terminate such a string when it is 
the first character within it (after an initial if any); e.g.. 
[]a—f] matches either a right square bracket (]) or one of the’ 
letters a through f inclusive. The four characters listed in 
1.2.a above stand for themselves within such a string of 
characters. 

The following rules may be used to construct REs from one- 

character REs: 

2.1 A one-character RE is a RE that matches whatever the one- 
character RE matches. 

2.2 A one-character RE followed by an asterisk (•) is a RE that 
matches zero or more occurrences of the one-character RE. If 
there is any choice, the longest leftmost string that permits a 
match is chosen. 

2.3 A one-character RE followed by \fm\{, NC[m,\j, or \{m,n\\ 

is a RE that matches a range of occurrences of the one- 
character RE. The values of m and n must be non-negative 
integers less than 256; \ [ m\ J matches exactly m occurren¬ 
ces; matches at least m occurrences; \{m,n\J 

matches any number of occurrences between m and n 
inclusive. Whenever a choice exists, the RE matches as many 
occurrences as possible. 

2.4 The concatenation of REs is a RE that matches the concatena¬ 
tion of the strings matched by each component of the RE. 

2.5 A RE enclosed between the character sequences \ ( and \) is a 
RE that matches whatever the unadorned RE matches. 

2.6 The expression \n matches the same string of characters as 
was matched by an expression enclosed between \( and \) 
earlier in the same RE. Here n is a digit; the sub-expression 
specified is that beginning with the n-th occurrence of \( 
counting from the left. For example, the expression 
^\(.*\)\1J matches a line consisting of two repeated 
appearances of the same string. 

Finally, an entire RE may be constrained to match only an initial 

segment or final segment of a line (or both): 
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3.1 A circumflex (^) at the beginning of an entire RE constrains 
that RE to match an initial segment of a line. 

3.2 A currency symbol (J) at the end of an entire RE constrains 
that RE to match a final segment of a line. The construction 
^ entire REX constrains the entire RE to match the entire line. 

The null RE (e.g., //) is equivalent to the last RE encountered. See 
also the last paragraph before FILES below. 

To understand addressing in ed it is necessary to know that at any 
time there is a current line. Generally speaking, the current line is 
the last line affected by a command; the exact effect on the current 
line is discussed under the description of each command. 
Addresses are constructed as follows: 

1. The character . addresses the current line. 

2. The character X addresses the last line of the buffer. 

3. A decimal number n addresses the n-th line of the buffer. 

4. 'x addresses the line marked with the mark name character x, 
which must be a lower-case letter. Lines are marked with the 
k command described below. 

5. A RE enclosed by slashes (/) addresses the first line found by 
searching forward from the line following the current line 
toward the end of the buffer and stopping at the first line con¬ 
taining a string matching the RE. If necessary, the search 
wraps around to the beginning of the buffer and continues up 
to and including the current line, so that the entire buffer is 
searched. See also the last paragraph before FILES below. 

6. A RE enclosed in question marks (?) addresses the first line 
found by searching backward from the' line preceding the 
current line toward the beginning of the buffer and stopping 
at the first line containing a string matching the RE. If neces¬ 
sary, the search wraps around to the end of the buffer and 
continues up to and including the current line. See also the 
last paragraph before FILES below. 

7. An address followed by a plus sign (+) or a minus sign (—) fol¬ 
lowed by a decimal number specifies that address plus 
(respectively minus) the indicated number of lines. The plus 
sign may be omitted. 

8. If an address begins with + or —, the addition or subtraction is 
taken with respect to the current line; e.g, —5 is understood to 
mean .—5. 

9. If an address ends with + or —, then 1 is added to or subtrac¬ 
ted from the address, respectively. As a consequence of this 
rule and of rule 8 immediately above, the address — refers to 
the line preceding the current line. (To maintain compatibil¬ 
ity with earlier versions of the editor, the character ^ in 
addresses is entirely equivalent to —.) Moreover, trailing + and 
— characters have a cumulative effect, so — refers to the 
current line less 2. 
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10. For convenience, a comma (.) stands for the address pair l.S. 
while a semicolon (;) stands for the pair ..S. 

Commands may require zero, one, or two addresses. Commands 
that require no addresses regard the presence of an address as an 
error. Commands that accept one or two addresses assume default 
addresses when an insufficient number of addresses is given; if more 
addresses are given than such a command requires, the last one(s) 
are used. 

Typically, addresses are separated from each other by a comma (,). 
They may also be separated by a semicolon (;). In the latter case, 
the current line (.) is set to the first address, and only then is the 
second address calculated. This feature can be used to determine 
the starting line for forward and backward searches (see rules 5. 
and 6. above). The second address of any two-address sequence 
must correspond to a line that follows,, in the buffer, the line 
corresponding to the first address. 

In the following list of ed commands, the default addresses are 
shown in parentheses. The parentheses are not part of the address; 
they show that the given addresses are the default. 

It is generally illegal for more than one command to appear on a 
line. However, any command (except e, /, r, or w) may be suffixed 
by p or by 1, in which case the current line is either printed or 
listed, respectively, as discussed below under the p and l com¬ 
mands. 

(-)a 

<text> 

The append command reads the given-text and appends it 
after the addressed line; . is left at -the last inserted line, or, 
if there were none, at the addressed line. Address 0 is legal 
for this command: it causes the “appended” text to be pla¬ 
ced at the beginning of the buffer. 

()c 

<text> 

The change command deletes the addressed lines, then 
accepts input text that replaces these lines; . is left at the 
last line input, or, if there were none, at the first line that 
was not deleted. 

The delete command deletes the addressed lines from the 
buffer. The line after the last line deleted becomes the 
current line; if the lines deleted were originally at the end of 
the buffer, the new last line becomes the current line. 

efile 

The edit command causes the entire contents of the buffer 
to be deleted, and then the named file to be read in; . is set 
to the last line of the buffer. If no file name is given, the 
currently-remembered file name, if any, is used (see the f 
command). The number of characters read is typed; file is 
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remembered for possible use as a default file name in subse¬ 
quent e, r, and w commands. If file begins with !, the rest of 
the line is taken to be a shell (s/i(l)) command whose output 
is to be read. Such a shell command is not remembered as 
the current file name. See also DIAGNOSTICS below. 

E file 

The .Edit command is like e, except that the editor does not 
check to see if any changes have been made to the buffer 
since the last w command. 

I file 

If file is given, the /ile-name command changes the 
currently-remembered file name to file-, otherwise, it prints 
the currently-remembered file name. 

(1 ,t)g/ RE/command list 

In the global command, the first step is to mark every line 
that matches the given RE. Then, for every such line, the* 
given command list is executed with . initially set to that 
line. A single command or the first of a list of commands 
appears on the same line as the global command. All lines of 
a multi-line list except the last line must be ended with a \; 
a, t, and c commands and associated input are permitted; 
the . terminating input mode may be omitted if it would be 
the last line of the command list. An empty command list is 
equivalent to the p command. The g, G, v, and V commands 
are not permitted in the command list. See also BUGS and 
the last paragraph before FILES below. 

(1,S)G /RE/ 

In the interactive Global command, the first step is to mark 
every line that matches the given RE. Then, for every such 
line, that line is printed, . is changed to that line, and any 
one command (other than one of the a, c, i, g, G, v, and V 
commands) may be input and is executed. After the execu¬ 
tion of that command, the next marked line is printed, and 
so on; a new-line acts as a null command; an tc causes the 
re-execution of the most recent command executed within 
the current invocation of G. Note that the commands input 
as part of the execution of the G command may address and 
affect any lines in the buffer. The G command can be ter¬ 
minated by an interrupt signal (ASCII DEL or BREAK). 

h 

The Aelp command gives a short error message that explains 
the reason for the most recent ? diagnostic. 

H 

The Help command causes ed to enter a mode in which error 
messages are printed for all subsequent ? diagnostics. It will 
also explain the previous ? if there was one. The H command 
alternately turns this mode on and off; it is initially off. 

()i 
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<text> 

The insert command inserts the given text before the 
addressed line; . is left at the last inserted line, or, if there 
were none, at the addressed line. This command differs from 
the a command only in the placement of the input text. 
Address 0 is not legal for this command. 

The join command joins contiguous lines by removing the 
appropriate new-line characters. If only one address is 
given, this command does nothing. 

(.)kx 

The marl: command marks the addressed line with name z, 
which must be a lower-case letter. The address 'x then 
addresses this line;. is unchanged. 

(.01 

The fist command prints the addressed lines in an unambi¬ 
guous way; a few non-printing characters (e.g., fab, back¬ 
space) are represented by (hopefully) mnemonic overstrikes, 
all other non-printing characters are printed in octal, and 
long lines are folded. An f command may be appended to any 
other command other than e,f, r, or w. 

(...)ma 

The move command repositions the addressed line(s) after 
the line addressed by a. Address 0 is legal for a and causes 
the addressed line(s) to be moved to the beginning of the file; 
it is an error if address a falls within the range of moved 
lines;. is left at the last line moved. 

(.,.)n 

The number command prints the addressed lines, preceding 
each line by its line number and a tab character; . is left at 
the last line printed. The n command may be appended to 
any other command other than e,f,r, or w. 

(•••)P 

The print command prints the addressed lines; . is left at the 
last line printed. The p command may be appended to any 
other command other than e, /, r, or w; for example, dp 
deletes the current line and prints the new current line. 

P 

The editor will prompt with a • for all subsequent commands. 
The P command alternately turns this mode on and off; it is 
initially off. 

q 

The guit command causes ed to exit. No automatic write of a 
file is done (but see DIAGNOSTICS below). 

Q 

The editor exits without checking if changes have been made 
in the buffer since the last w command. 
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(S)r file 

The f'ead command reads in the given file after the 
addressed line. If no file name is given, the currently- 
remembered file name, if any, is used (see e and / com¬ 
mands). The currently-remembered file name is not changed 
unless file is the very first file name mentioned since ecf was 
invoked. Address 0 is legal for r and causes the file to be 
read at the beginning of the buffer. If the read is successful, 
the number of characters read is typed; . is set to the last 
line read in. If file begins with !, the rest of the line is taken 
to be a shell (s/i(l)) command whose output is to be read. 
Such a shell command is not remembered as the current file 
name. 


(.,.)s /RE /replacement/ or 

(...)s /RE/replacement /g 

The substitute command searches each addressed line for an 
occurrence of the specified RE. In each line in which a match 
is found, all (non-overlapped) matched strings are replaced 
by the replacement if the global replacement indicator g 
appears after the command. If the global indicator does not 
appear, only the first occurrence of the matched string is 
replaced. It is an error for the substitution to fail on all 
addressed lines. Any character other than space or new-line 
may be used instead of / to delimit the RE and the repla¬ 
cement’, . is left at the last line on which a substitution 
occurred. See also the last paragraph before FILES below.. . 

An ampersand (&) appearing in the replacement is replaced 
by the string matching the RE on the current line. The 
special meaning of & in this context may be suppressed by 
preceding it by \. As a more general feature, the characters 
\n, where n is a digit, are replaced by the text matched by 
the n-th regular subexpression of the specified RE enclosed 
between \( and \). When nested parenthesized subexpres¬ 
sions are present, n is determined by counting occurrences 
of \( starting from the left. When the character % is the 
only character in the replacement, the replacement used in 
the most recent substitute command is used as the repla¬ 
cement in the current substitute command. The % loses its 
special meaning when it is in a replacement string of more 
than one character or is preceded by a \. 

A line may be split by substituting a new-line character into 
it. The new-line in the replacement must be escaped by pre¬ 
ceding it by \. Such substitution cannot be done as part of 
ajrorv command list. 


(...)ta 


This command acts just like the m command, except that a 
copy of the addressed lines is placed after address a (which 
may be 0); . is left at the last line of the copy. 


The undo command nullifies the effect of the most recent 
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command that modified anything in the buffer, namely the 
most recent a, c, d, g, i,j, m, r, s, t, v, G. or V command. 

(1, S)v/RE/command list 

This command is the same as the global command g except 
that the command list is executed with . initially set to every 
line that does not match the RE. 


(1 ,S)V/RE/ 

This command is the same as the interactive global command 
G except that the lines that are marked during the first step 
are those that do not match the RE. 


(l,S)w;«e 

The ti/rite command writes the addressed lines into the 
named file. If the file does not exist, it is created with mode 
666 (readable and writable by everyone), unless your umask 
setting (see sh(l)) dictates otherwise. The currently- 
remembered file name is not changed unless file is the very 
first file name mentioned since ed was invoked. If no file 
name is given, the currently-remembered file name, if any, is 
used (see e and f commands); . is unchanged. If the com¬ 
mand is successful, the number of characters written is 
typed. If file begins with !, the rest of the line is taken to be 
a shell (sh(D) command whose output is to be read. Such a 
shell command is not remembered as the current file name. 


X 

A key string is demanded from the standard input. Subse¬ 
quent e, r, and w commands will encrypt and decrypt the 
text with this key by the algorithm of crypf(l). An explicitly 
empty key turns off encryption. 

(S)= 

The line number of the addressed line is typed; . is 
unchanged by this command. 



'shell 


command 

The remainder of the line after the ! is sent to the UNIX shell 
(sh( 1)) to be interpreted as a command. Within the text of 
that command, the unescaped character % is replaced with 
the remembered file name; if a ! appears as the first charac¬ 
ter of the shell command, it is replaced with the text of the 
previous shell command. Thus, !! will repeat the last shell 
command. If any expansion is performed, the expanded line 
is echoed;. is unchanged. 


(.+l)<new-line> 

An address alone on a line causes the addressed line to be 
printed. A new-line alone is equivalent to .+lp; it is useful 
for stepping forward through the buffer. 

If an interrupt signal (ASCII DEL or BREAK) is sent, ed prints a ? and 
returns to its command level. 


Some size limitations: 512 characters per line, 256 characters per 
global command list, 64 characters per file name, and 128K 
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characters in the buffer. The limit on the number of lines depends 
on the amount of user memory: each line takes 1 word. 

When reading a file, ed discards ASCII NUL characters and all charac¬ 
ters after the last new-line. Files (e.g., a.out) that contain charac¬ 
ters not in the ASCII set (bit 8 on) cannot be edited by ed. 

If the closing delimiter of a RE or of a replacement string (e.g., /) 
would be the last character before a new-line, that delimiter may be 
omitted, in which case the addressed line is printed. The following 
pairs of commands are equivalent: 
s/sl/s2 s/sl/s2/p 
g/si g/sl/p 

?sl '?sl? 

FILES 

/tmp/e# 

temporary; § is the process number, 
ed.hup work is saved here if the terminal is hung up. 

DIAGNOSTICS 

? for command errors. 

file for an inaccessible file. 

(use the help and Help commands for detailed explanations). 

If changes have been made in the buffer since the last w command that 
wrote the entire buffer, ed warns the user if an attempt is made to des¬ 
troy ed ’s buffer via the e or q commands: it prints ? and allows one to 
continue editing. A second e or q command at this point will take effect. 
The — command-line option inhibits this feature. 

SEE ALSO 

crypt(l), grep(l), sed(l), sh(l). 

A Tutorial Introduction to the UNIX Text Editor by B. W. Kemighan. 
Advanced Editing on UNIX by B. W. Kernighan. 

CAVEATS AND BUGS 

A / command cannot be subject to a g or a v command. 

The / command and the ! escape from the e, r, and w commands cannot 
be used if the the editor is invoked from a restricted shell (see sh(l)). 

The sequence \n in a RE does not match any character. 

The l command mishandles DEL. 

Files encrypted directly with the crypf(l) command with the null key 
cannot be edited. 

Because 0 is an illegal address for the w command, it is not possible to 
create an empty file with ed. 
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NAME 

env — set environment for command execution 


SYNOPSIS 

env [—] [ name=value ] ... [ command args ] 


DESCRIPTION 

Env obtains the current environment, modifies it according to its 
arguments, then executes the command with the modified environment. 
Arguments of the form name=value are merged into the inherited 
environment before the command is executed. The — flag causes the 
inherited environment to be ignored completely, so that the command is 
executed with exactly the environment specified by the arguments. 

If no command is specified, the resulting environment is printed, one 
name-value pair per line. 


SEE ALSO 

sh(l), exec(2), profile(5), environ(7). 
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NAME 

eqn, neqn, checkeq — format mathematical text for nroff or troff 


SYNOPSIS 

eqn [ — dxy ] [ —pn ] [ —an ] [ —fn ] [ files ] 
neqn [ —dxy ] [ —pn ] [ —an ] [ —fn ] [ files ] 
checkeq [ files ] 

DESCRIPTION 

Eqn is a troff ( 1) preprocessor for typesetting mathematical text on a 
Wang Laboratories, Inc. C/A/T phototypesetter, while neqn is used for 
the same purpose with nroff ( 1) on typewriter-like terminals. Usage is 
almost always: 

eqn files | troff 
neqn files | nroff 

or equivalent. 

If no files are specified, these programs read from the standard input. A 
line beginning with JCQ marks the start of an equation; the end of an 
equation is marked by a line beginning with JIN. Neither of these lines is 
altered, so they may be defined in macro packages to get centering, 
numbering, etc. It is also possible to designate two characters as delimi¬ 
ters ; subsequent text between delimiters is then treated as egn input. 
Delimiters may be set to characters x and y with the command-line 
argument —dxy or (more commonly) with delim xy between JIQ and JIN. 
The left and right delimiters may be the same character; the dollar sign 
is often used as such a delimiter. Delimiters are turned off by delim off. 
All text that is neither between delimiters nor between .EQ and JIN is 
passed through untouched. 

The program checkeq reports missing or unbalanced delimiters and 
.EQ/.EN pairs. 

Tokens within egn are separated by spaces, tabs, new-lines, braces, 
double quotes, tildes, and circumflexes. Braces {J are used for grouping; 
generally speaking, anywhere a single character such as x could appear, 
a complicated construction enclosed in braces may be used instead. 
Tilde («-) represents a full space in the output, circumflex (>*) half as 
much. 


Subscripts and superscripts are produced with the keywords sub and 
sup. Thus x sub j makes x jt a sub k sup 2 produces a* 2 , while •**♦*“ is 
made with e sup (x sup 2 + y sup 2 \. Fractions are made with over: 

a over b yields £■; sqrt makes square roots: I over sqrt {ax sup 2+bx+c j 

results in -r=~==r . 

v bx 2 +6x +e 


The keywords from and to introduce lower and upper limits: lim£x t is 

nSfl q 

made with limfrom |n —> inf { sum from 0 to n x sub i. Left and right 
brackets, braces, etc., of the right height are made with left and right: 

left [ x sup 2 + y sup 2 over alpha right ] 1 produces ’ “ ' 


* 4.111 


x*+ 


= 1 . 


Legal characters after left and right are braces, brackets, bars, c and f 
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for ceiling and floor, and "" for nothing at all (useful for a right-side-only 
bracket). A left thing need not have a matching right thing. 

Vertical piles of things are made with pile, lpile, cpile, and rpile: 

a 

pile (a above b above c{ produces b. Piles may have arbitrary numbers 

G 

of elements; lpile left-justifles, pile and cpile center (but with different 
vertical spacing), and rpile right justifies. Matrices are made with matrix: 

1 

matrix { leol \ x sub i above y sub 2 } ccol } 1 above 2 J { produces 2 . 
In addition, there is rcol for a right-justified column. 

Diacritical marks are made with dot, dotdot, hat, tilde, bar. wee, dyad, 
and under x dot = f(t) bar is x=f{t), y dotdot bar n under is y = n, 

and x vee y dyad is & * &. 

Point sizes and fonts can be changed with size n or size ±n, roman, italic, 
bold, and font n. Point sizes and fonts can be changed globally in a 
document by gsize n and gfont n, or by the command-line arguments 
—sn and —In. 

Normally, subscripts and superscripts are reduced by 3 points from the 
previous size; this may be changed by the command-line argument —pn. 

Successive display arguments can be lined up. Place mark before the 
desired lineup point in the first equation; place lineup at the place that is 
to line up vertically in subsequent equations. 

Shorthands, may be defined or existing keywords redefined with define: 
define thing 55 replacement 7% 

defines a new token called thing that will be replaced by replacement 
whenever it appears thereafter. The Z may be any character that does 
not occur in replacement. 

Keywords such as sum (£). int (/). inf (-). and shorthands such as >= (*>. 
!= (*). and -> (-•) are recognized. Greek letters are spelled out in the 
desired case, as in alpha (a), or GAUHA (D- Mathematical words such as 
sin, cos, and log are made Roman automatically. Troff {\) four-character 
escapes such as \(dd (J) and \(bs (©may be used anywhere. Strings 
enclosed in double quotes (*'...") are passed through untouched; this 
permits keywords to be entered as text, and can be used to communicate 
with troff (l) when all else fails. Full details are given in the manual cited 
below. 

SEE ALSO 

Typesetting Mathematics—User's Guide by B. W. Kernighan and L L 
Cherry. 

New Graphic Symbols for EQN and NEQN by C. Scrocca. 
mm(l), mmt(l), tbl(l), troff (1), eqnchar(7), mm(7), mv(7). 

BUGS 

To embolden digits, parentheses, etc., it is necessary to quote them, as in 
bold "12.3". 

See also BUGS under troff { l). 
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NAME 

f77 — Fortran 77 compiler 
SYNOPSIS 

f77 [ option ] ... file ... 

DESCRIPTION 

F77 is the UNIX Fortran 77 compiler. It accepts several types of 
arguments: 

Arguments whose names end with *.f are taken to be Fortran 77 source 
programs; they are compiled, and each object program is left on the file 
in the current directory whose name is that of the source with ‘.o' substi¬ 
tuted for \f’. 

Arguments whose names end with *.r* or *.e’ are taken to be Ratfor or EFL 
source programs, respectively; these are first transformed by the 
appropriate preprocessor, then compiled by f77. 

In the same way, arguments whose names end with \c’ or '.s’ are taken to 
. be C or assembly source programs and are compiled or assembled, pro¬ 
ducing a ‘.o’ file. 

Floating point is implemented with the Motorola Fast Floating Point 
Package. The compiler will accept double precision declarations, but 
handles them silently as single precision. 

The following options have the same meaning as in cc(l). See ld( l) for 
load-time options. 

—c Suppress loading and produce ‘.o’ files for each source file. 

—p Prepare object files for profiling, see prof( 1). 

—S Compile the named programs, and leave the assembler-listing on 

corresponding files suffixed ’.s’. 

—o output 

Name the final output file output instead of 'a.out’. 

The following options are peculiar to /77. 

—onetrip 

Compile DO loops that are performed at least once if reached. 
(Fortran 77 DO loops are not performed at all if the upper limit is 
smaller than the lower limit.) 

—1 Same as ’-onetrip’. 

—U Do not convert UPPERCASE to lowercase. 

—u Make the default type of a variable ’undefined’ rather than using 

the default Fortran rules. 

—C Compile code to check that subscripts are within declared array 

bounds. 

—w Suppress all warning messages. If the option is ’—w66’, only For¬ 

tran 66 compatibility warnings are suppressed. 

—Nz Change default sizes of certain tables, ’x’ is one of the letters 
q,x,s,c or n followed directly by a decimal number. The defaults 
are: 
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-Nql50 Maximum number of equivalence statements 
-Nx200 Maximum number of external definitions 
-Ns701 Maximum number of statement labels 
-Nc20 Maximum nesting of control structures 
-Nn401 Size of hash table 

—12 Use short integers (2 bytes) for Fortran type integer. 

—14 Use long integers (4 bytes) for Fortran type integer (default). 
Additionally, make subscripts long. 

—Is Make subscripts short (default). 

—F Apply EFL and Ratfor preprocessor to relevant files, put the result 

in the file with the suffix changed to \f\ but do not compile. 

—m Apply the M4 preprocessor to each *.r’ or *.e’ file before transfor¬ 

ming it with the Ratfor or EFL preprocessor. 

—Ex Use the string * as an EFL option in processing \e' files. 

—R* Use the string * as a Ratfor option in processing \r* files. 

Other arguments are taken to be either loader option arguments, or 
F77-compatible object programs, typically produced by an earlier run, or 
perhaps libraries of F77-compatible routines. These programs, together 
with the results of any compilations specified, are loaded (in the order 
given) to produce an executable program with name 'a.out'. 


FILES 


file.[fresc] 

file.o 

a.out 

/usr / lib / f77pass I 

/lib/cl 

/lib/c2 

/usr/lib/libF77.a 
/ usr / lib / libI77. a 
/lib/libc.a 
/lib/libm.a 
/lib/libffp.a 


input file 
object file 
loaded output 
compiler 
pass 2 
pass3 

intrinsic function library 
Fortran I/O library 
C library, see section 3 
Mathematical library 
Floating point library 


SEE ALSO 

S. I. Feldman, P. J. Weinberger, A Portable Fortran 77 Compiler 
prof(l), cc(l), ld(l) 

DIAGNOSTICS 

The diagnostics produced by f77 itself are intended to be self- 
explanatory. Occasioned messages may be produced by the loader. 


BUGS 


This compiler has run the Fortran Compiler Validation Suite FCVS 78 
from the Federal Cobol Compiler Test Service (FCCTS). FCVS 78 is also 
known as "navytest". It passed all tests except two. One error is due to 
floating point accuracy. The other error is that a format statement must 
be given before an "assign"-statement that assigns the label of the for¬ 
mat statement to an integer variable. 
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NAME 

find — find files 
SYNOPSIS 

find path-name-list expression 
DESCRIPTION 

Find recursively descends the directory hierarchy for each path name in 
the path-name-list (i.e., one or more path names) seeking files that 
match a boolean expression written in the primaries given below. In the 
descriptions, the argument n is used as a decimal integer where +n 
means more than n, —w means less than n and n means exactly n. 


—name file 

True if file matches the current file name. Normal shell 
argument syntax may be used if escaped (watch out for [, 
? and •). 

—perm onum 

True if the file permission flags exactly match the octal 
number onum (see c/imod(l)). If onum is prefixed by a 
minus sign, more flag bits (017777, see stat{ 2)) become 
significant and the flags are compared: 

(flags&onum)==onum 

—type c 

True if the type of the file is c, where c is b, c, d, p, or f for 
block special file, character special file, directory, fifo 
(a.k.a named pipe), or plain file. 

—links n 

True if the file has n links. 


—user unarm True if the file belongs to the user uname. If tmame is 
numeric and. does not appear as a login name in the 
/etc/passwd file, it is taken as a user ID. 

—group gname 

True if the file belongs to the group gname. If gname is 


—size n 

—atime n 

—mtimen 

—ctime n 

—exec cmd 

numeric and does not appear in the /etc/group file, it is 
taken as a group ID. 

True if the file is n blocks long (512 bytes per block). 

True if the file has been accessed in n days. 

True if the file has been modified in n days. 

True if the file has been changed in n days. 

True if the executed cmd returns a zero value as exit sta¬ 
tus. The end of cmd must be punctuated by an escaped 
semicolon. A command argument f j is replaced by the 
current path name. 

—ok cmd 

Like —exec except that the generated command line is 
printed with a question mark first, and is executed only if 
the user responds by typing y. 

—print 
—cpio device 

Always true; causes the current path name to be printed. 

Write the current file on device in cpio (5) format (5120 
byte records). 
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—newer file True if the current file has been modified more recently 
than the argument file. 

( expression ) True if the parenthesized expression is true (parentheses 
are special to the shell and must be escaped). 

The primaries may be combined using the following operators (in order of 
decreasing precedence): 

1) The negation of a primary (! is the unary not operator). 

2) Concatenation of primaries (the and operation is implied by the jux¬ 
taposition of two primaries). 


3) Alternation of primaries (—o is the or operator). 

EXAMPLE 

To remove all files named a.out or *.o that have not been accessed for a 
week: 

find / \ ( -name a.out —o -name '•.o' \) -atime +7 -exec rm {j \; 


FILES 

/etc/passwd, /etc/group 
SEE ALSO 

cpio(l), sh(l), test(l), stat(2), cpio(5), fs(5). 


•\ 



> 
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NAME 

fsdb — file system debugger 


SYNOPSIS 

/etc/fsdb special [ — ] 

DESCRIPTION 

Fsdb can be used to patch up a damaged file system after a crash. It has 
conversions to translate block and i-numbers into their corresponding 
disk addresses. Also included are mnemonic offsets to access different 
parts of an i-node. These greatly simplify the process of correcting con¬ 
trol block entries or descending the file system tree. 

Fsdb contains several error checking routines to verify i-node and block 
addresses. These can be disabled if necessary by invoking fsdb with the 
optional — argument or by the use of the O symbol. (Fsdb reads the i- 
size and f-size entries from the superblock of the file system as the basis 
for these checks.) 

Numbers are considered decimal by default. Octal numbers must be 
prefixed with a zero. During any assignment operation, numbers are 
checked for a possible truncation error due to a size mismatch between 
source and destination. 

Fsdb reads a block at a time and will therefore work with raw as well as 
block I/O. A buffer management routine is used to retain commonly used 
blocks of data in order to reduce the number of read system calls. All 
assignment operations result in an immediate write-through of the 
corresponding block. 

The symbols recognized by fsdb are: 

# absolute address 

i convert from i-number to i-node address 

b convert to block address 

d directory slot offset 

+,— address arithmetic 

q quit 

>,< save, restore an address 

= numerical assignment 

=+ incremental assignment 

=— decremental assignment 

=" character string assignment 

0 error checking flip flop 

p general print facilities 

f file print facility 

B byte mode 

W word mode 

D double word mode 

! escape to shell 

The print facilities generate a formatted output in various styles. The 
current address is normalized to an appropriate boundary before prin¬ 
ting begins. It advances with the printing and is left at the address of the 
last item printed. The output can be terminated at any time by typing 
the delete character. If a number follows the p symbol, that many 
entries are printed. A check is made to detect block boundary overflows 
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since logically sequential blocks are generally not physically sequential. 
If a count of zero is used, all entries to the end of the current block are 
printed. The print options available are: 


i print as i-nodes 


d print as directories 

o print as octal words 


e print as decimal words 


c print as characters 

b print as octal bytes 


The f symbol is used to print data blocks associated with the current i- 
node. If followed by a number, that block of the file is printed. (Blocks 
are numbered from zero.) The desired print option letter follows the 
block number, if present, or the f symbol. This print facility works for 
small as well as large files. It checks for special devices and that the 
block pointers used to find the data are not zero. 

Dots, tabs and spaces may be used as function delimiters but are not 7) 

necessary. A line with just a new-line character will increment the 
current address by the size of the data type last printed. That is, the 
address is set to the next byte, word, double word, directory entry or i- 
node, allowing the user to step through a region of a file system. Infor¬ 
mation is printed in a format appropriate to the data type. Bytes, words 
and double words are displayed with the octal address followed by the 
value in octal and decimal. A J or J) is appended to the address for byte 
and double word values, respectively. Directories are printed as a direc¬ 
tory slot offset followed by the decimal i-number and the character 
representation of the entry name. Inodes are printed with labeled fields 
describing each element. 

The following mnemonics are used for i-node examination and refer to 
the current working i-node: 

md mode 

In link count 

uid user ID number 

gid group ID number 

sO high byte of file size 

si low word of file size > 

a# data block numbers (0 — 12) 

at access time 

mt modification time 

maj major device number 

min minor device number 


EXAMPLES 

386i 


prints i-number 386 in an i-node format. This now 
becomes the current working i-node. 

changes the link count for the working i-node to 4. 

increments the link count by 1. 

prints, in ASCII, block zero of the file associated with the 
working i-node. 


In=4 

ln=+l 

fc 
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2i.fd prints the first 32 directory entries for the root i-node of 

this file system. 

d5i.fc changes the current i-node to that associated with the 5th 

directory entry (numbered from zero) found from the 
above command. The first 512 bytes of the file are then 
printed in ASCII. 

lb.pOo prints the superblock of this file system in octal. 

2i.a0b.d7=3 changes the i-number for the seventh directory slot in the 
root directory to 3. This example also shows how several 
operations can be combined on one command line. 

d7.nm="name" 

changes the name field in the directory slot to the given 
string. Quotes are optional when used with nm if the first 
character is alphabetic. 

SEE ALSO 

fsck(lM), dir(5), fs(5). 
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NAME 

getopt — parse command options 
SYNOPSIS 

set — 'getopt optstring !•' 

DESCRIPTION 

Getopt is used to break up options in command lines for easy parsing by 
shell procedures, and to check for legal options. Optstring is a string of 
recognized option letters (see getopt(3C)); if a letter is followed by a 
colon, the option is expected to have an argument which may or may not 
be separated from it by white space. The special option — is used to 
delimit the end of the options. Getopt will place — in the arguments at 
the end of the options, or recognize it if used explicitly. The shell 
arguments (31 82 . . .) are reset so that each option is preceded by a — 
and in its own shell argument; each option argument is also in its own 
shell argument. 

DIAGNOSTICS 

Getopt prints an error message on the standard error when it encounters 
an option letter not included in optstring. 

EXAMPLE 

The following code fragment shows how one might process the arguments 
for a command that can take the options a and b, and the option o, 
which requires an argument. 

set — 'getopt abo: 3*' 

if [ 3? != 0 ] 

then 

echo 3USAGE 
exit 2 
fi 

for i in 8* 
do 

case Si in 

—a | —b) FLAG=Si; shift;; 

—o) 0ARG=S2; shift; shift;; 

—) shift; break;; 

esac 

done 

This code will accept any of the following as equivalent: 

cmd —aoarg file file 
cmd —a —o arg file file 
cmd —oarg —a file file 
cmd —a —oarg — file file 

SEE ALSO 

sh(l), getopt(3C). 
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NAME 

hyphen — find hyphenated words 

SYNOPSIS 

hyphen files 

DESCRIPTION 

Hyphen finds all the hyphenated words in files and prints them on the 
standard output. If no arguments are given, the standard input is used. 
Thus hyphen may be used as a filter. 

BUGS 

Hyphen can’t cope with hyphenated italic (i.e., underlined) words; it will 
often miss them completely, or mangle them. 

Hyphen occasionally gets confused, but with no ill effects other than 
spurious extra output. 
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NAME 

id — print user and group IDs and names 

SYNOPSIS 

id 

DESCRIPTION 

Id writes a message on the standard output giving the user and group IDs 
and the corresponding names of the invoking process. If the effective 
and real IDs do not match, both are printed. 

SEE ALSO 

logname(l), getuid(2), getgid(2). 
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NAME 

install — install commands 


SYNOPSIS 

install [ —c dira ] [ —f dirb ] [ —i ] [ —n dire ] [ — o ] [ — s ] file [ 

dirx ... ] 


DESCRIPTION 

Install is a command most commonly used in "makefiles” (see maJce(l)) 
to install a file (updated target file) in a specific place within a file sys¬ 
tem. Each file is installed by copying it into the appropriate directory, 
thereby retaining the mode and owner of the original command. The 
program prints messages telling the user exactly what files it is replacing 
or creating and where they are going. 

If no options or directories ( dirx ...) are given, install will search (using 
find( 1)) a set of default directories (/bin, /usr/bin, /etc, /lib, and 
/usr/Ub, in that order) for a file with the same name as file. When the 
first occurrence is found, install issues a message saying that it is 1 
overwriting that file with file, and proceeds to do so. If the file is not 
found, the program states this and exits without further action. 

If one or more directories ( dirx ...) are specified after file, those direc¬ 
tories will be searched before the directories specified in the default list. 

The meanings of the options are: 

—c dira Installs a new command in the directory specified in 

dira. Looks lor file in dira and installs it there if it is 
not found. If it is found, install issues a message say¬ 
ing that the file already exists, and exits without 
overwriting it. May be used alone or with the —s 
option. 

—f dirb Forces file to be installed in given directory, whether 
or not one already exists. If the file being installed 
does not already exist, the mode and owner of the new 
file will be set to 755 and bin, respectively. If the file 
already exists, the mode and owner will be that of the 
already existing file. May be used alone or with the —o 
or —s options. 


—i Ignores default directory list, searching only through 

the given directories (dirx ...). May be used alone or 
with any other options other than —c and —f. 

—n dire If file is not found in any of the searched directories, 

it it put in the directory specified in dire. The mode 
and owner of the new file will be set to 755 and bin, 
respectively. May be used alone or with any other 
options other than —c and —f. 

—o If file is found, this option saves the "found” file by 

copying it to OUHfile in the directory in which it was 
found. May be used alone or with any other options 
other than —c. 
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—n Suppresses printing of messages other than error 

messages. May be used alone or with any other 
options. 

SEE ALSO 

mk(8). 
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NAME 

Id — loader 
SYNOPSIS 

Id [ option ] file ... 

DESCRIPTION 

Ld combines several object programs into one, resolves external referen¬ 
ces, and searches libraries. In the simplest case several object files are 
given, and Id combines them, producing an object module which can be 
either executed or become the input for a further Id run. (In the latter 
case, the —r option must be given to preserve the relocation bits.) The 
output of Id is left on a.out. This file is made executable only if no errors 
occurred during the load. 

The argument routines are concatenated in the order specified. The 
entry point of the output is the beginning of the first routine. 

If any argument is a library, it is searched exactly once at the point it is 
encountered in the argument list. Only those routines defining an 
unresolved external reference are loaded. If a routine from a library 
references another routine in the library, and the library has not been 
processed by ranlib(l), the referenced routine must appear after the 
referencing routine in the library. Thus the order of programs within 
libraries may be important. If the first member of a library is named 

•_.SYMDEF’, then it is understood to be a dictionary for the library such 

as produced by ranlib; the dictionary is searched iteratively to satisfy as 
many references as possible. 

The symbols *^_etext’, *__edata’ and *_end’ (*etext\ ’edata’ and 'end' in C) 

are reserved, and if referred to, are set to the first location above the 
program, the first location above initialized data, and the first location 
above all data respectively. It is erroneous to define these symbols. 

Ld understands several options. Except for —1, they should appear before 
the file names. _ 

s ’Strip’ the output, that is, remove the symbol table and relocation 
bits to save space (but impair the usefulness of the debugger). 
This information can also be removed by sfrtp(l). 

—u Take the following argument as a symbol and enter it as undefined 

in the symbol table. This is useful for loading wholly from a 
library, since initially the symbol table is empty and an unresolved 
reference is needed to force the loading of the first routine. 

—lx This option is an abbreviation for the library name '/lib/libx.a', 
where x is a string. If that does not exist. Id tries ’/usr/lib/libx.a’. 
A library is searched when its name is encountered, so the pla¬ 
cement of a —1 is significant. 

—4 This option changes the library name ’/lib/libx.a’ to ’/lib/libLx.a’. 
For example instead of /lib/libc.a the library /lib/libLc.a is sear¬ 
ched. These libraries are assumed to include modules which have 
been produced with cc -4. 

—x Do not preserve local (non-.globl) symbols in the output symbol 
table; only enter external symbols. This option saves some space 
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-d 


P 



in the output file. 

Generate relocation bits in the output file so that it can be the 
subject of another Id run. This flag also prevents final definitions 
from being given to common symbols, and suppresses the 
‘undefined symbol' diagnostics. 

Force definition of common storage even if the —r flag is present. 

The name argument after —o is used as the name of the Id output 
file, instead of a.out. 

This argument produces a symbol listing on stdout. 

This argument links objects for an unmapped address range, such 
that code, data and bss are contiguous, starting from 0. Useful for 
Macsbug etc. 

This option is used to link unix or standalone programs, where 
code is in segment 0 and data and bss in segment 1. If neither —b 
nor —y are given, normal user-mode programs loadable by the ker¬ 
nel are produced, with code in segment 6 and data and bss in seg¬ 
ment 8. 


—m This option produces "S-records" for Macsbug on file dm.out. 

—e The following argument is taken to be the name of the entry point 

of the loaded program; location 0 is the default. 

—0 This is an overlay file, only the text segment will be replaced by 

exec(2). Shared data must have the same layout as in the pro¬ 
gram overlaid. 

—D The next argument is a decimal number that sets the size of the 

data segment. 


FILES 

/lib/lib*.a libraries 

/lib/libL*.a libraries with four-byte integers 

/usr/lib/lib*.a more libraries 



a.out 
EE ALSO 


output file 


as(l), ar(l), cc(l), ranlib(l) 


BUGS 

Overlays -ire not tested. 
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NAME 

line — read one line 

SYNOPSIS 

line 

DESCRIPTION 

Line copies one line (up to a new-line) from the standard input and wri¬ 
tes it on the standard output. It returns an exit code of 1 on EOF and 
always prints at least a new-line. It is often used within shell files to read 
from the user’s terminal. 

SEE ALSO 

sh(l), read(2). 
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NAME 

logname — get login name 

SYNOPSIS 

logname 

DESCRIPTION 

Logname returns the contents of the environment variable SLOGNAUE, 
which is set when a user logs into the system. 

FILES 

/etc/profile 
SEE ALSO 

env(l), login(l), logname(3X), environ(7). 
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—F cause directories to be marked with a trailing 7’ and executable files to be marked with 

a trailing *•’; this is the default if the last character of the name the program is invoked 
with is a T. 

—R recursively list subdirectories encountered. 

The mode primed under the —1 option contains 11 characters which are interpreted as follows: 
the first character is 

d if the entry is a directory; 
b if the entry is a block-type special file; 
e if the entry is a character-type special file; 
m if the entry is a multiplexor-type character special file; 

— if the entry is a plain file. 



The next 9 characters are interpreted as three sets of three bits each. The first set refers to 
owner permissions; the next to permissions to others in the same user-group; and the last to all 
-'hers. Within each set the three characters indicate permission respectively to read, to write, 
^ to execute the file as a program. For a directory, ‘execute’ permission is interpreted to mean 
permission to search the directory for a specified file. The permissions are indicated as follows: 


r if the file is readable; 
w if the file is writable; 
x if the file is executable; 

— if the indicated permission is not granted. 


The group-execute permission character is given as s if the file has set-group-ID mode; likewise 
the user-execute permission character is given as s if the file has set-user-ID mode. 

The last character of the mode (normally ‘x’ or *—’) is t if the 1000 bit of the mode is on. See 
cfimod(\) for the meaning of this mode. 

When the sizes of the files in a directory are listed, a total count of blocks, including indirect 
blocks is printed. 


LES 

/etc/passwd to get user ID’s for ‘Is —T. 
/etc/group to get group ID’s for ‘Is — g\ 


I^S 


{pewline and tab 


are considered printing characters in file names. 


The output device is assumed to be 80 columns wide. 

The option setting based on whether the output is a teletype is undesirable as “Is —s’’ is much 
different than “Is -s | lpr”. On the other hand, not doing this setting would make old shell 
scripts which used Is almost certain losers. 

Column widths choices are poor for terminals which can tab. 
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NAME 

is — list contents of directory 


SYNOPSIS 

Is [ — abcdfgilmqrstuxlCFR ] name ... 
1 [ Is options ] name 


DESCRIPTION 

For each directory argument. Is lists the contents of the directory; for each file argument. Is 
repeats its name and any other information requested. The output is sorted alphabetically by 
de f ault- When no argument is given, the current directory is listed. When several arguments 
are given, the arguments are first sorted appropriately, but file arguments appear before direc¬ 
tories and their contents. 



There are three major listing formats. The format chosen depends on whether the output is 
going to a teletype, and may also be controlled by option flags. The default format for a tele¬ 
type is to list the contents of directories in multi-column format, with the entries sorted down 
the columns. (Files which are not the contents of a directory being interpreted are always 
sorted across the page rather than down the page in columns. This is because the individual file 
names may be arbitrarily long.) If the standard output is not a teletype, the default format is to 
list one entry per line. Finally, there is a stream output format in which files are listed across 
the page, separated by V characters. The — tn flag enables this format; when invoked as / this 
format is also used. 

There are an unbelievable number of options: 

—l I i«t in long format, giving mode, number of links, owner, size in bytes, and time of 
last modification for each file. (See below.) If the file is a special file the size field will 
instead contain the major and minor device numbers. 

—t Sort by time modified (latest first) instead of by name, as is normal. 




—r 
—a 
—c 


-i 

-f 


-1 


List ail entries; usually V and are suppressed. 

Give size in blocks, including indirect blocks, for each entry. 

If argument is a directory, list only its name, not its contents (mostly used with —l to 
get status on directory). 

Reverse the order of sort to get reverse alphabetic or oldest first as appropriate. 

Use time of last access instead of last modification for sorting (—t) or printing (—1). 
Use time of file creation for sorting or printing. 

Print i-number in first column of the report for each file listed. 

Force each argument to be interpreted as a directory and list the name found in each 
slot. This option turns off —I, — t, —s, and — r, and turns on —a; the order is the 
order in which entries appear in the directory. 

Give group ID instead of owner ID in long listing. 


—m force stream output format 

—1 force one entry per line output format, e.g. to a teletype 


—C force multi-column output, e.g. to a file or a pipe 

—q force printing of non-graphic characters in file names as the character 4 ?’; this normally 
happens only if the output device is a teletype 

—b force printing of non-graphic characters to be in the \ddd notation, in octal. 

—x force columnar printing to be sorted across rather than down the page: this is the 

default if the last character of the name the program is invoked with is an *x*. 




\ 


3rd Berkeley Distribution 


3/26/80 


l 








M4(l) 


MUNDC 


M4(l) 


NAME 

m4 — macro processor 
SYNOPSIS 

m4 [ options ] [ files ] 

DESCRIPTION 

U4 is a macro processor intended as a front end for Ratfor, C, and other 
languages. Each of the argument files is processed in order; if there are 
no files, or if a file name is —, the standard input is read. The processed 
text is written on the standard output. 

The options and their effects are as follows: 

—e Operate interactively. Interrupts are ignored and the output is 

unbuffered. Using this mode requires a special state of mind. 

—a Enable line sync output for the C preprocessor (fline ...) 

—Btnf Change the size of the push-back and argument collection buffers 
from the default of 4,096. 

—Hinf Change the size of the symbol table hash array from the default of 
199. The size should be prime. 

—Sinf Change the size of the call stack from the default of 100 slots. 
Macros take three slots, and non-macro arguments take one. 

—Ttnf Change the size of the token buffer from the default of 512 bytes. 

To be effective, these flags must appear before any file names and before 
any —D or —U flags: 

—Dname [ =t/al ] 

Defines name to val or to null in val's absence. 

—U name 

undefines name. 

Macro calls have the form: 

name(argl,arg2, .... argn) 

The ( must immediately follow the name of the macro. If a defined macro 
name is not followed by a (, it is deemed to have no arguments. Leading 
unquoted blanks, tabs, and new-lines are ignored while collecting 
arguments. Potential macro names consist of alphabetic letters, digits, 
and underscore where the first character is not a digit. 

Left and right single quotes are used to quote strings. The value of a 
quoted string is the string stripped of the quotes. 

When a macro name is recognized, its arguments are collected by sear¬ 
ching for a matching right parenthesis. Macro evaluation proceeds nor¬ 
mally during the collection of the arguments, and any commas or right 
parentheses which happen to turn up within the value of a nested call 
are as effective as those in the original input text. After argument col¬ 
lection, the value of the macro is pushed back onto the input stream and 
'rescanned. 

M4 makes available the following built-in macros. They may be redefined, 
but once this is done the original meaning is lost. Their values are null 
unless otherwise stated. 
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define the second argument is installed as the value of the macro 
whose name is the first argument. Each occurrence of Sn in 
the replacement text, where n is a digit, is replaced by the n- 
th argument. Argument 0 is the name of the macro; missing 
arguments are replaced by the null string; f# is replaced by 
the number of arguments; S* is replaced by a list of all the 
arguments separated by commas; %9 is like S*. but each 
argument is quoted (with the current quotes). 


undefine removes the definition of the macro named in its argument. 

defn returns the quoted definition of its argument(s). It is useful 

for renaming macros, especially built-ins. 


pushdef 

popdef 



ifdef 


like define, but saves any previous definition. 

removes current definition of its argument(s), exposing the 
previous one if any. 

if the first argument is defined, the value is the second 
argument, otherwise the third. If there is no third argument, 
the value is null. The word unix is predefined on UNIX versions 
of m.4. 


shift returns all but its first argument. The other arguments are 

quoted and pushed back with commas in between. The quo¬ 
ting nullifies the effect of the extra scan that will subse¬ 
quently be performed. 

changequote 

change quote symbols to the first and second arguments. The 
symbols may be up to five characters long. Changequote 
without arguments restores the original values (i.e., ' 


changecom 


change left and right comment markers from the default # 
and new-line. With no arguments, the comment mechanism is 
effectively disabled. With one argument, the left marker 
becomes the argument and the right marker becomes new- 
line. With two arguments, both markers are affected. Com¬ 
ment markers may be up to five characters long. 


divert m4 maintains 10 output streams, numbered 0-9. The final 
output is the concatenation of the streams in numerical 
order, initially stream 0 is the current stream. The divert 
macro changes the current output stream to its (digit-string) 
argument. Output diverted to a stream other than 0 through 
9 is discarded. 


undivert causes immediate output of text from diversions named as 
arguments, or all diversions if no argument. Text may be 
undiverted into another diversion. Undiverting discards the 
diverted text. 


divnum returns the value of the current output stream. 

dnl reads and discards characters up to and including the next 

new-line. 
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if else 


incr 


deer 

eval 


len 

index 

substr 


translit 


include 

sinclude 

sysemd 

sysval 
make temp 

m4exit 

m4wrap 

errprint 

dumpdef 


has three or more arguments. If the first argument is the 
same string as the second, then the value is the third 
argument. If not, and if there are more than four arguments, 
the process is repeated with arguments 4, 5, 6 and 7. Oth¬ 
erwise, the value is either the fourth string, or, if it is not 
present, null. 

returns the value of its argument incremented by 1. The 
value of the argument is calculated by interpreting an initial 
digit-string as a decimal number. 

returns the value of its argument decremented by 1. 

evaluates its argument as an arithmetic expression, using 32- 
bit arithmetic. Operators include +, —, •. /, X, ~ (exponentia¬ 
tion), bitwise &, |, *\ and ~; relational; parentheses. Octal and 
hex numbers may be specified as in C. The second argument 
specifies the radix for the result; the default is 10. The third 
argument may be used to specify the minimum number of 
digits in the result. 

returns the number of characters in its argument. 

returns the position in its first argument where the second 
argument begins (zero origin), or —1 if the second argument 
does not occur. 

returns a substring of its first argument. The second 
argument is a zero origin number selecting the first charac¬ 
ter; the third argument indicates the length of the substring. 
A missing third argument is taken to be large enough to 
extend to the end of the first string. 

transliterates the characters in its first argument from the 
set given by the second argument to the set given by the 
third. No abbreviations are permitted. 

returns the contents of the file named in the argument. 

is identical to include, except that it says nothing if the file is 
inaccessible. 

executes the UNIX command given in the first argument. No 
value is returned. 

is the return code from the last call to sysemd. 

fills in a string of XXXXX in its argument with the current pro¬ 
cess ID. 

causes immediate exit from m4. Argument 1, if given, is the 
exit code; the default is 0. 

argument 1 will be pushed back at final EOF; example; 
m4wrap('cleanup()') 

prints its argument on the diagnostic output file. 

prints current names and definitions, for the named items, or 
for all if no arguments are given. 
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traceon with no arguments, turns on tracing for all macros (including 
built-ins). Otherwise, turns on tracing for named macros. 

traceoff turns off trace globally and for any macros specified. Macros 
specifically traced by froceon can be untraced only by 
specific calls to traceoff. 

SEE ALSO 

The M4 Macro Processor by B. W. Kemighan and D. M. Ritchie. 
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NAME 

mail, rmail - send mail to users or read mail 


SYNOPSIS 

mail [ —rpq ] [ —f file ] 


mail persons 


rmail persons 


DESCRIPTION 

Mail without arguments prints a user’s mail, message-by-message, in 
last-in, first-out order. For each message, the user is prompted with a ?, 
and a line is read from the standard input to determine the disposition of 
the message: 


<new-line> 

+ 

d 

P 

s [ files ] 
w [ files ] 

m [ persons ] 

q 

EOT (control-d) 

X 

Jcommand 


Go on to next message. 

Same as <new-line>. 

Delete message and go on to next message. 

Print message again. 

Go back to previous message. 

Save message in the named files (mbox is default). 

Save message, without its header, in the named files 
(mbox is default). 

Mail the message to the named persons (yourself is 
default). 

Put undeleted mail back in the mailfile and stop. 

Same as q. 

Put all mail back in the mailfile unchanged and stop. 
Escape to the shell to do command. 

Print a command summary. 


The optional arguments alter the printing of the mail: 


—r causes messages to be printed in first-in, first-out order. 

—p causes all mail to be printed without prompting for disposition. 

—q causes mail to terminate after interrupts. Normally an interrupt 

only causes the termination of the message being printed. 

—Ifile causes mail to use file (e.g., mbox) instead of the default mailfile. 

When persons are named, mail takes the standard input up to an end- 
of-file (or up to a line consisting of just a .) and adds it to each person’s 
mailfile. The message is preceded by the sender’s name and a postmark. 
Lines that look like postmarks in the message, (i.e., "From...’’) are pre¬ 
ceded with a >. A person is usually a user name recognized by fogtn(l). 
If a person being sent mail is not recognized, or if mail is interrupted 
during input, the dead.letter will be saved to allow editing and resending. 


To denote a recipient on a remote system, prefix person by the system 
name and exclamation mark (see uucp (1C)). Everything after the first 
exclamation mark in persons is interpreted by the remote system. In 
particular, if persons contains additional exclamation marks, it can 
denote a sequence of machines through which the message is to be sent 
on the way to its ultimate destination. For example, specifying a!b!cde as 
a recipient’s name causes the message to be sent to user bfcde on system 
a. System a will interpret that destination as a request to send the mes¬ 
sage to user cde on system b. This might be useful, for instance, if the 
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sending system can access system a but not system b, and system a has 
access to system b. 

The mailfile may be manipulated in two ways to alter the function of 
mail. The other permissions of the file may be read-write, read-only, or 
neither read nor write to allow different levels of privacy. If changed to 
other than the default, the file will be preserved even when empty to per¬ 
petuate the desired permissions. The file may also contain the first line: 

Forward to person 

which will cause all mail sent to the owner of the mailfile to be forwarded 
to person. This is especially useful to forward all of a person’s mail to 
one machine in a multiple machine environment. 

Rmail only permits the sending of mail; tmcp(lC) uses rmaiL as a secu¬ 
rity precaution. 

When a user logs in he is informed of the presence of mail, if any. 



to identify sender and locate persons 
incoming mail for user •; mailfile 
saved mail 
mailfile 
temporary file 


/etc/passwd 
/usr/mail/* 
SHOME/mbox 
3 MAIL 


/tmp/ma* t 

/usr/mail/ *Jock 


lock tor mail directory 
dead.letter unmailable text 


SEE ALSO 


login(l), uucp(lC). write(l). 

Race conditions sometimes result in a failure to remove a lock file. 

After an interrupt, the next message may not be printed; printing may be 
forced by typing a p. 
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NAME 

make - maintain, update, and regenerate groups of programs 

make [—f makefile] [—p] [—i] [—k] [—s] [—r] [—n] [—b] [—e] [—m] [—t] 

[—q] [—d] [names] 

DESCRIPTION . . 

The following is a brief description of all options and some special names. 

—f makefile Description file name. Makefile is assumed to be the name of 
a description file. A file name of — denotes the standard 
input. The contents of makefile override the built-in rules if 
they are present. 

-p Print out the complete set of macro definitions and target 

descriptions. 

_i Ignore error codes returned by invoked commands. This 

mode is entered if the fake target name .IGNORE appears in 
the description file. 

—k Abandon work on the current entry, but continue on other 

branches that do not depend on that entry. 

—a Silent mode. Do not print command lines before executing. 

This mode is also entered if the fake target name .SILENT 
appears in the description file. 

Do not use the built-in rules. 

No execute mode. Print commands, but do hot execute 
them. Even lines beginning with an @ are printed. 

Compatibility mode for old makefiles. 

Environment variables override assignments within 
makefiles. 

Print a memory map showing text, data, and stack. This 
option is a no-operation on systems without the getu system 
call. 

Touch the target files (causing them to be up-to-date) 
rather than issue the usual commands. 

—d Debug mode. Print out detailed information on files and 

times examined. 

—q Question. The make command returns a zero or non-zero 

status code depending on whether the target file is or is not 
up-to-date. 

.DEFAULT If a file must be made but there are no explicit commands or 
relevant built-in rules, the commands associated with the 
name .DEFAULT are used if it exists. 

.PRECIOUS Dependents of this target will not be removed when quit or 
interrupt are hit. 

.SILENT Same effect as the —s option. 


—r 
—n 

-b 


—m 


-t 
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.IGNORE Same effect as the —i option. 

Make executes commands in makefile to update one or more target 
names. Name is typically a program. If no —f option is present, makefile, 
Makefile, * makefil e, and s.Makefile are tried in order. If makefile is —, 
the standard input is taken. More than one -f makefile argument pair 


may appear. 

Make updates a target only if it depends on files that are newer than the 
target. All prerequisite files of a target are added recursively to the list 
of targets. Missing files are deemed to be out of date. 

Makefile contains a sequence of entries £hat specify dependencies. The 
first line of an entry is a blank-separated, non-null list of targets, then a 
:, then a (possibly null) list of prerequisite files or dependencies. Text 
following a ; and all following lines that begin with a tab are shell com¬ 
mands to be executed to update the target. The first line that does not 
begin with a tab or # begins a new dependency or macro definition. Shell 
commands may be continued across lines with the <backslashXnew- 
line> sequence. Sharp (#) and new-line surround comments. 


The following makefile says that pgm depends on two files a.o and b.o, 
and that they in turn depend on their corresponding source files (a.c and 
b.c) and a common file incl.h: 


pgm: a.o b.o 

cc a.o b.o —o pgm 

a. o: incl.h a.c 

cc —c a.c 

b. o: incl.h b.c 

cc —c b.c 


Command lines are executed one at a time, each by_ its own shell. A line 
is printed when it is executed unless the —s option is present, or the 
entry .SILENT: is in makefile, or unless the first character of the com¬ 
mand is ©. The —n option specifies printing without execution; however, 
if the command line has the string X(MAKE) in it, the line is always execu¬ 
ted (see discussion of the UAKEFLAGS macro under Environment). The —t 
(touch) option updates the modified date of a file without executing any 
commands. 


Commands returning non-zero status normally terminate make. If the —i 
option is present, or the entry .IGNORE: appears in makefile, or if the line 
specifying the command begins with <tab><hyphen>, the error is 
ignored. If the —k option is present, work is abandoned on the current 
entry, but continues on other branches that do not depend on that 
entry. 

The —b option allows old makefiles (those written for the old version of 
make) to run without errors. The difference between the old version of 
make and this version is that this version requires all dependency lines 
to have a (possibly null) command associated with them. The previous 
version of make assumed if no command was specified explicitly that the 
command was null. 


Interrupt and quit cause the target to be deleted unless the target 
depends on the special name .PRECIOUS. 


( 
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Environment 

The environment is read by make. All variables are assumed to be macro 
definitions and processed as such. The environment variables are pro¬ 
cessed before any makefile and after the internal rules; thus, macro 
assignments in a makefile override environment variables. The —e option 
causes the environment to override the macro assignments in a makefile. 

The MAKEFLAGS environment variable is processed by make as containing 
any legal input option (except —f, —p, and —d) defined for the command 
line. Further, upon invocation, make "invents" the variable if it is not in 
the environment, puts the current options into it, and passes it on to 
invocations of commands. Thus, MAKEFLAGS always contains the current 
input options. This proves very useful for "super-makes". In fact, as 
noted above, when the —n option is used, the command S(MAKE) is execu¬ 
ted anyway; hence, one can perform a make —n recursively on a whole 
software system to see what would have been executed. This is because 
the —n is put in MAKEFLAGS and passed to further invocations of S(MAKE)._ 
This is one way of debugging all of the makefiles for a software project 
without actually doing anything. 

Macros 

Entries of the form string 1 — string2 are macro definitions. Subsequent 
appearances of 8(sfrangri[:subsfi=[su6sf^]]) are replaced by string2. 
The parentheses are optional if a single character macro name is used 
and there is no substitute sequence. The optional :substl=subst2 is a 
substitute sequence. If it is specified, all non-overlapping occurrences of 
substl in the named macro are replaced by subst2. Strings (for the pur¬ 
poses of this type of substitution) are delimited by blanks, tabs, new-line 
characters, and beginnings of lines. An example of the use of the substi¬ 
tute sequence is shown under Libraries. 

Internal Macros 

There are five internally maintained macros which are useful for writing 
rules for building targets. 

$• The macro S* stands for the file name part of the current dependent 
with the suffix deleted. It is evaluated only for inference rules. 

The X@ macro stands for the full target name of the current target. 
It is evaluated only for explicitly named dependencies. 

S< The S< macro is only evaluated for inference rules or the .DEFAULT 
rule. It is the module which is out of date with respect to the target 
(i.e., the "manufactured” dependent file name). Thus, in the .c.o 
rule, the $< macro would evaluate to the .c file. An example for 
making optimized .o files.from .c files is: 

.c.o: 

cc —c —0 S*.c 
or: 

.c.o: 

cc —c —0 S< 

S? The S? macro is evaluated when explicit rules from the makefile are 
evaluated. It is the list of prerequisites that are out of date with 
respect to the target; essentially, those modules which must be 
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rebuilt. 

S/C The S3 • macro is only evaluated when the target is an archive library 
member of the form lib(file.o). In this case, S® evaluates to lib and 
S% evaluates to the library member, file.o. 

Four of the five macros can have alternative forms. When an upper case 
D or F is appended to any of the four macros the meaning is changed to 
••directory part” for D and "file part" for F. Thus, S(®D) refers to the 
directory part of the string S®. If there is no directory part. The only 
macro excluded from this alternative form is S?. The reasons for this are 
debatable. 

Suffixes 

Certain names (for instance, those ending with .o) have inferable prere¬ 
quisites such as .c, .s, etc. If no update commands for such a file appear 
in makefile, and if an inferable prerequisite exists, that prerequisite is 
compiled to make the target. In this case, make has inference rules 
which allow building files from other files by examining the suffixes and 
determining an appropriate inference rule to use. The current default 
inference rules are: 

.c -c~ .sh .sh~ .c.o .c~.o .c~.c .s.o .s~.o .y.o .y~.o .l.o .l~.o 
.y.c .y~.c .l.c .c.a .c~.a .s'-'.a .h~.h 

The internal rules for make are contained in the source file rules.c for 
the make program. These rules can be locally modified. To print out the 
rules compiled into the make on any machine in a form suitable for 
recompilation, the following command is used: 

make —fp -» 2>/dev/null </dev/null 

The only peculiarity in this output is the (null) string which prinif( 3S) 
prints when handed a null string. 

A tilde in the above rules refers to an SCCS file (see sccsflle(5)). Thus, the 
rule .c~.o would transform an SCCS C source file into an object file (.o). 
Because the s. of the SCCS files is a prefix it is incompatible with make’s 
suffix point-of-view. Hence, the tilde is a way of changing any file 
reference into an SCCS file reference. 

A rule with only one suffix (i.e. .c:) is the definition of how to build x from 
x.c. In effect, the other suffix is null. This is useful for building targets 
from only one source file (e.g., shell procedures, simple C programs). 

Additional suffixes are given as the dependency list for .SUFFIXES. Order 
is significant; the first possible name for which both a file and a rule exist 
is inferred as a prerequisite. 

The default list is: 

SUFFIXES: .o .c .y .1 .s 

Here again, the above command for printing the internal rules will 
display the list of suffixes implemented on the current machine. Multiple 
suffix lists accumulate; .SUFFIXES: with no dependencies clears the list of 
suffixes. 

Inference Rules 

The first example can be done more briefly: 
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pgm: a.o b.o 

cc a.o b.o —o pgm 
a.o b.o: incl.h 

This is because make has a set of internal rules for building files. The 
user may add rules to this list by simply putting them in the makefile. 

Certain macros are used by the default inference rules to permit the 
inclusion of optional matter in any resulting commands. For example, 
CFLAGS. LFLAGS. and YFLAGS are used for compiler options to cc(l), lex( l), 
and yocc(l) respectively. Again, the previous method for examining the 
current rules is recommended. 

The inference of prerequisites can be controlled. The rule to create a file 
with suffix .o from a file with suffix .c is specified as an entry with .c.o: as 
the target and no dependents. Shell commands associated with the tar¬ 
get define the rule for making a .o file from a .c file. Any target that has 
no slashes in it and starts with a dot is identified as a rule and not a true 
target. 

Libraries 

If a target or dependency name contains parenthesis, it is assumed to be 
an archive library, the string within parenthesis referring to a member 
within the library. Thus lib(file.o) and S(LIB) (file.o) both refer to an 
archive library which contains file.o. (This assumes the UB macro has 
been previously defined.) The expression S(LIB)(filel.o file2.o) is not 
legal. Rules pertaining to archive libraries have the form XX .a where the 
XX is the suffix from which the archive member is to be made. An unfor¬ 
tunate byproduct of the current implementation requires the XX to be 
different from the suffix of the archive member. Thus, one cannot have 
lib(file.o) depend upon file.o explicitly. The most common use of the 
archive interface follows. Here, we assume the source files are all C type 
source: 

lib: lib(filel.o) lib(file2.o) lib(file3.o) • 

©echo lib is now-up to date 

.c.a: 

S(CC) -c S(CFLAGS) S< 
ar rv 8© 8*.o 
rm -f $*.o 

In fact, the .c.a rule listed above is built into make and is unnecessary in 
this example. A more interesting, but more limited example of an archive 
library maintenance construction follows: 

lib: lib(filel.o) lib(file2.o) lib(file3.o) 

S(CC) -c S(CFLAGS) 8(?:.o=.c) 
ar rv lib S? 

rm 8? ©echo lib is now up to date 

.c.a:; 

Here the substitution mode of the macro expansions is used. The 8? list 
is defined to be the set of object file names (inside lib) whose C source 
files are out of date. The substitution mode translates the .o to .c. 
(Unfortunately, one cannot as yet transform to ,c~; however, this may 
become possible in the future.) Note also, the disabling of the .c.a: rule, 
which would have created each object file, one by one. This particular 
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construct speeds up archive library maintenance considerably. This type 
of construct becomes very cumbersome if the archive library contains a 
mix of assembly programs and C programs. 


FILES 

[Mm]akefile 

s.[Mm]akefile 

SEE ALSO 

sh(l), mk(8). 

Make—A Program for Maintaining Computer Programs by S. I. Feldman. 
An Augmented Version of Make by E. G. Bradford. 


BUGS 




Some commands return non-zero status inappropriately; use —i to over¬ 
come the difficulty. Commands that are directly executed by the shell, 
notably cd(l), are ineffectual across new-lines in make. The syntax 
(lib(filel.o file2.o file3.o) is illegal. You cannot build lib(file.o) from file.o. 
The macro J(a:.o=s.c~) doesn’t work. 
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NAME 

move — copy directories 
SYNOPSIS 

move fromdir todir 

DESCRIPTION ' i _ j . ...... 

Move copies the directory fromdir with all its subdirectories to the direc¬ 
tory todir. 

The directory todir will be created if necessary. 

SEE ALSO 

cpio(l) 
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newconf — generate configuration file and reconfigure MUNIX 
SYNOPSIS 

/etc/newconf [ configuration file ] 

DESCRIPTION 

Newconf makes a new MUNIX kernel from an already existing or from an 
interactively created configuration file. 

If no configuration file is specified newconf asks for 

— the device drivers to be included 

(tty driver is automatically included) 

— assignation of DMA extension registers to DMA devices 

— the type and unit of the root and swap device 

— the origin (block number) and size of the swap area 

— some other system parameters 

Newconf creates the configuration file /usr/sys/conf.h as include file to 
the configuration table /usr/sys/c.c and the interrupt vector table 
/usr/sys/L.s. 

If a configuration file is specified this file is copied to /usr/sys/conf.h. 

Reconfiguration of MUNIX is automatically done by compiling 
/usr/sys/c.c, assembling /usr/sys /l.s and linking /usr/sys/c.o, 
/usr/sys/l.o, the kernel library /usr/sys /Lib 1 and the driver libraries 
/usr/sysAib2 and /usr/sys/lib3 to a new MUNIX kernel named /nunix. 

For later use you should safe the interactively created configuration file 
/usr/sys/conf.h by renaming it. 

Several drivers exist in two versions (for 18-bit and 22-bit controllers). 
These versions you can find in /usr/sys/libchoice. The appropriate ver¬ 
sion of each of those drivers (for your configuration) should be in 
/usr/sys/lib3. If the driver versions in /usr/sys Aib3 do not match your 
needs you have to exchange the wrong versions. 

FILES 

/usr/sys/conf.h 

/usr/sys/c.* 

/usr/sys/1.* 

/usr/sys/libl 

/usr/sys/lib2 

/usr/sys/lib3 

/usr/sys/libchoice 

/usr/sys/confinfo 

/nunix 

SEE ALSO 

whatconf (lm) 
confinfo (7) 

BUGS 
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NAME 

newgrp — log in to a new group 

SYNOPSIS 

newgrp [ group ] 

DESCRIPTION 

Newgrp changes the group identification of its caller, analogously to 
logrin(l). The same person remains logged in, and the current directory 
is unchanged, but calculations of access permissions to files are perfor¬ 
med with respect to the new group ID. 

Newgrp without an argument changes the group identification to the 
group in the password file; in effect it changes the group identification 
back to the caller's original group. 

A password is demanded if the group has a password and the user himself 
does not, or if the group has a password and the user is not listed in 
/etc/group as being a member of that group. 

When most users log in, they are members of the group named other. 

FILES 

/etc/group 

/etc/passwd 

SEE ALSO 

login(l), group(5). 

BUGS 

There is no convenient way to enter a password into /etc/group. 

Use of group passwords is not encouraged, because, by their very nature, 
they encourage poor security practices. Group passwords may disappear 
in the future. 


Page 1 


April 6, 1983 






NL(1) 


UUNIX 


NL( 1) 


NAME 

nl — line numbering filter 
SYNOPSIS 

nl [—htype] [—btype] [—ftype] [-▼start#] [—iincr] [—p] [—Inum] [—ssep] 
[—wwidth] [—nformat] file 

DESCRIPTION 

M reads lines from the named file or the standard input if no file is 
named and reproduces the lines on the standard output. Lines are num¬ 
bered on the left in accordance with the command options in effect. 

Nl views the text it reads in terms of logical pages. Line numbering is 
reset at the start of each logical page. A logical page consists of a 
header, a body, and a footer section. Empty sections are valid. Different 
line numbering options are independently available for header, body, and 
footer (e.g. no numbering of header and footer lines while numbering 
blank lines only in the body). 

The start of logical page sections are signaled by input lines containing 
nothing but the following character(s): 

Line contents Start of 
\:\:\: header 

\ :\: body 

\: footer 

Unless signaled otherwise, nl assumes the text being read is in a single 
logical page body. 

Command options may appear in any order and may be intermingled with 
an optional file name. Only one file may be named. The options are: 

—b type Specifies which logical page body lines are to be numbered. 

Recognized types and their meaning are: a, number all lines; t, 
number lines with printable text only; n, no line numbering; 
psfringr, number only lines that contain the regular expression 
specified in string. Default type for logical page body is t (text 
lines numbered). 

— htype Same as —b type except for header. Default type for logical 
page header is n (no lines numbered). 

—ftype Same as —b type except for footer. Default for logical page 
footer is n (no lines numbered). 

—p Do not restart numbering at logical page delimiters. 

—vsfarf# Start # is the initial value used to number logical page lines. 
Default is 1. 

—iincr Incr is the increment value used to number logical page lines. 
Default is 1. 

—ssep Sep is the character(s) used in separating the line number and 
the corresponding text line. Default sep is a tab. 

—wwidth Width is the number of characters to be used for the line num¬ 
ber. Default width is 6 . 
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—nformat 

Format is the line numbering format. Recognized values are: In. 
left justified, leading zeroes supressed; m, right justified, 
leading zeroes supressed; rz, right justified, leading zeroes kept. 
Default format is m (right justified). 

—lnttm Num is the number of blank lines to be considered as one. For 
example, —12 results in only the second adjacent blank being 
numbered (if the appropriate —ha, —ba, and/or —fa option is 
set). Default is 1. 

SEE ALSO 

pr(l). 



\ 

-/ 



3 


April 6, 1983 


Page 2 






PASTE(1) 


UUNIX 


PASTE(1) 


NAME 

paste — merge same lines of several files or subsequent lines of one file 

SYNOPSIS 

paste filel file2 ... 
paste —dlist filel file2 ... 
paste —8 [—dlist] filel file2 ... 

DESCRIPTION 

In the first two forms, paste concatenates corresponding lines of the 
given input files filel , file2, etc. It treats each file as a column or 
columns of a table and pastes them together horizontally (parallel mer¬ 
ging). If you will, it is the counterpart of caf (1) which concatenates ver¬ 
tically, i.e., one file after the other. In the last form above, paste sub¬ 
sumes the function of an older command with the same name by com¬ 
bining subsequent lines of the input file (serial merging). In all cases, 
lines are glued together with the tab character, or with characters from 
an optionally specified list. Output is to the standard output, so it can 
be used as the start of a pipe, or as a filter, if — is used in place of a file 
name. 

The meanings of the options are: 

—d Without this option, the new-line characters of each but the last 

file (or last line in case of the —a option) are replaced by a fab 
character. This option allows replacing the fab character by one 
or more alternate characters (see below). 

list One or more characters immediately following —d replace the 
default fab as the line concatenation character. The list is used 
circularly, i. e. when exhausted, it is reused. In parallel merging (i. 
e. no —a option), the lines from the last file are always terminated 
with a new-line character, not from the list. The list may contain 
the special escape sequences: \n (new-line), \t (tab), \\ 
(backslash), and \0 (empty string, not a-null character). Quoting 
may be necessary, if characters have special meaning to the shell 
(e.g. to get one backslash, use —ef"\\\ \" ). 

—s Merge subsequent lines rather than one from each input file. Use 

fab for concatenation, unless a list is specified with —d option. 
Regardless of the ftsf, the very last character of the file is forced 
to be a new-line. 

— May be used in place of any file name, to read a line from the stan¬ 
dard input. (There is no prompting). 

EXAMPLES 

Is | paste —d” " — list directory in one column 

Is | paste — -- list directory in four columns 

paste —s —d"\ t\ n" file combine pairs of lines into lines 

SEE ALSO 

grep(l), cut(l), 

pr(l): pr —t — m... works similarly, but creates extra blanks, tabs and 
new-lines for a nice page layout. 
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DIAGNOSTICS 

line too long 

too many files 



Output lines are restricted to 511 characters. 

Except for —a option, no more than 12 input files may 
be specified. 
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NAME 

ped - "screen oriented editor" 

SYNOPSIS 

ped <file> 

DESCRIPTION 

Ped is an interactive, screen oriented editor. <file> is 
the name of the file to be edited. Ped is initially in 
REPLACE mode: move the cursor around the screen, then type 
away. ENTER i, ENTER 1 etc. switch to the following modes: 

REPLACE 

INSERT 

LINE 

FIND 

USE 

WINDOW POSIT 
SAVE 

END EDITING 
AREA 

PARAGRAPH 

TAG 

CHANGE KEYS 
COMMAND 


Cursor position with the four arrow keys: , T » » and -> 

. The HOME key 'amplifies' the following cursor key, e.g. 
HOME -> moves the cursor to the right margin of the window. 
If the cursor is already at the right margin, HOME -> moves 
the window half a page right. Similarly, HOME | moves the 
cursor to the top margin, or moves up half a page. HOME 
HOME moves the cursor to the limits of the text, in this 
case to the last line. 

Delete a^ character : hitting DEL CHAR deletes the character 
at the cursor position; DELETE or BACK SPACE deletes the 
character left of the cursor position. 

Hitting ENTER switches into the COMMAND mode, and gives a 
'menu' list of the various commands. 

LINE operations : delete (d), insert (i), split (s), remove 
the rest of (r) a line. 


FIND : ENTER f^ find-string finds the next occurrence of 
'find-string' in the file. 

ENTER f looks for the same 'find-string' again. ENTER f T 
looks up instead of down. 
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USE: ENTER u <file name> RETURN switches to another file. 


WINDOW POSITION : ENTER w line number RETURN or or T 
moves to a given line number in the file. ENTER w +20 
goes down 20 lines , ENTER w -20 t goes up 20 lines , 
ENTER w +20 -> goes right 20 columns. 

SAVE , END EDITING asks if you really want to change the 
file. Answer to save, or n to continue editing. END 
EDITING closes the file and goes back to Unix. 


In AREA mode, first mark a range of lines by: 
m — mark the top line, 
move the cursor, 
m — mark the bottom line. 

Then you can delete (d), insert blank lines (i), copy (c) 
the marked lines. ( Copy copies just below the current 
cursor position). 


PARAGRAPH is like AREA , for rectangles instead of line 
ranges. First: 

M — mark the corner of a rectangle, 
move the cursor, 

M — mark the opposite corner of the rectangle. 

Then delete (d), horizontal insert (h), vertical insert (v), 
replace (r) with the upper left corner of the rectangle at 
the current cursor position. 


CALLING : If you call ped then ped looks for a description 
file in the directory / usr/lib / red/PE<ttynumber> . <username> 

. The contents of such a file is the file name of the last 
file you edited and the position in that file. If such a 
file exists for your terminal number and user name, then ped 
takes the last file you edited and positions where you left 
it. If you call ped -f search or you type ped -w line then 
ped positons in the last file edited to the string search or 
the line line . 


TAG : If you call ped -_t search or you type ENTER jt search 
RETURN or or T then ped looks in the file tags in the 
current directory for the entry search . (See also ctags 
(1)) . It opens the corresponding file and positions to the 
line where procedure or function search is declared. This 
works for C and PASCAL files. 


CHANGE KEYS: to expand a single letter to a long word, like 
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'M' to 'Mississippi', type: 

ENTER ENTER <delimiter> <Mississippi> <delimiter> <M>. 
Then hitting 'M' is the same as typing in 'Mississippi'. 

The expanded 'word' can also contain editor commands, as in: 
/ENTER f ENTER r replace/M 

The ENTER x. command displays all expand keys, in the format 
<expand key>: <sequence for this key>. 


The ENTER £ command escapes to the unix shell . EOT 
(control-z) returns to Ped. 


KEYBOARD 

The CURSOR keys and some other special keys are different 
from keyboard to keyboard. Therefore the / etc/termcap data 
base contains a translation for these keys to an internal 
representation. See also termcap (_3) and termcap (5_) . The 
new termcap entries all start with 'y'. 


yl => 

ENTER 

y2 => 

DELETE 

y3 => 

BACKSPACE 

y4 => 

TAB 

y5 => 

DEL CHAR 

y6 => 

RETURN 

y7 => 

BACKTAB 

y8 => 

REFRESH 

y9 -> 

KILL LINE 

ya =*> 

+ PAGE 

yb => 

- PAGE 

yc => 

+ LINE 

yd => 

- LINE 

ye => 

INSERT LINE 

yf => 

DELETE LINE 

yg => 

CURSOR UP 

yh => 

CURSOR DOWN 

yi => 

CURSOR RIGHT 

yj => 

CURSOR LEFT 

yk => 

CURSOR HOME 

If your 

keyboard has 


install additional functions: 

+/- PAGE (LINE) moves the text in the window up/down one 
(half a) page. INSERT, DELETE LINE inserts or deletes a 
line without changing the current mode. 


FILES 

/tmp/text<pid> 

/etc/termcap 

/usr/lib/red/PE<t tynumber>.<username> 


Vs^C 0 
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AUTHOR 

Arnulf P.A. Wiedemann 
ZT ZTI INF 212 
Siemens AG 
Otto-Hahn-Ring 6 
D 8000 Muenchen 83 


BUGS 

AREA is not well tested. 
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NAUE 

pr — print files 
SYNOPSIS 

pr [ options ] [ files ] 

DESCRIPTION 

Pr prints the named files on the standard output. If file is —, or if no files 
are specified, the standard input is assumed. By default, the listing is 
separated into pages, each headed by the page number, a date and time, 
and the name of the file. 

By default, columns are of equal width, separated by at least one space; 
lines which do not fit are truncated. If the —s option is used, lines are not 
truncated and columns are separated by the separation character. 

If the standard output is associated with a terminal, error messages are 
withheld until pr has completed printing. 

Options may appear singly or be combined in any order. Their meanings 
are: 

+fc Begin printing with page k (default is 1). 

—k Produce fc-column output (default is 1). The options —e and —i are 
assumed for multi-column output. 

—a Print multi-column output across the page. 

-*m Merge and print all files simultaneously, one per column (overrides 
the —k, and —a options). 

—d Double-space the output. 

—ock Expand input tabs to character positions fc + l, 2*Jfc+l, 3*fc+l, etc. 
If fc is 0 or is omitted, default tab settings at every eighth position 
are assumed. Tab characters in the input are expanded into the 
appropriate number of spaces. If c (any nOn-digit character) is 
given, it is treated as the input tab character (default for c is the 
tab character). 

—ick In output, replace white space wherever possible by inserting tabs 
to character positions fc+l, 2*fc+l, 3 *k+X, etc. If fc is 0 or is omit¬ 
ted, default tab settings at every eighth position are assumed. If c 
(any non-digit character) is given, it is treated as the output tab 
character (default for c is the tab character). 

—nek Provide fc-digit line numbering (default for k is 5). The number 
occupies the first A:+l character positions of each column of nor¬ 
mal output or each line of —m output. If c (any non-digit charac¬ 
ter) is given, it is appended to the line number to separate it from 
whatever follows (default for c is a tab). 

—w k Set the width of a line to k character positions (default is 72 for 
equal-width multi-column output, no limit otherwise). 

—ok Offset each line by k character positions (default is 0). The num¬ 
ber of character positions per line is the sum of the width and 
offset. 
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—Vc Set the length of a page to k lines (default is 66). 

—h Use the next argument as the header to be printed instead of the 

hie name. 

—p Pause before beginning each page if the output is directed to a 

terminal (jpr will ring the bell at the terminal and wait for a carri¬ 
age return). 

—f Use form-feed character for new pages (default is to use a 

sequence of line-feeds). Pause before beginning the first page if 
the standard output is associated with a terminal. 

—r Print no diagnostic reports on failure to open files. 

—t Print neither the five-line identifying header nor the five-line 

trailer normally supplied for each page. Quit printing after the 
last line of each file without spacing to the end of the page. 

—sc Separate columns by the single character c instead of by the 
appropriate number of spaces (default for c is a tab). 

EXAMPLES 

Print filel and file2 as a double-spaced, three-column listing headed by 
"file list": 

pr —3dh "file list" filel file2 

Write filel on file2, expanding tabs to columns 10, 19, 28, 37,... 
pr —e9 —t <filel >file2 

FILES 

/dev/tty* to suspend messages 

SEE ALSO 

cat(l). 
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NAME 

print — print files on the line printer 

SYNOPSIS 

print file ... 

DESCRIPTION 

Print produces a printed listing of one or more files with line numbers on 
the line printer. The output is preceeded by a banner page with the 
user’s login name. A printed file is separated into pages headed by the 
date, the filename and the page number. 

FILES 

/dev/tty? to suspend messages. 

SEE ALSO 

lpr(l), pr(l) 
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NAME 

pwck, grpck — password/group file checkers 

SYNOPSIS 

pwck [file] 
grpck [file] 

DESCRIPTION 

Pwck scans the password file and notes any inconsistencies. The checks 
include validation of the number of fields, login name, user ID, group ID, 
and whether the login directory and optional program name exist. The 
criteria for determining a valid login name are taken from Setting Up 
UNIX. The default password file is /etc/passwd. 

Grpck verifies all entries in the group file. This verification includes a 
check of the number of fields, group name, group ID, and whether all 
login names appear in the password file. The default group file is 
/etc/group. 

FILES 

/etc/group 
/etc/passwd 

SEE ALSO 

group(5), passwd(5). 

Setting Up UNIX. 

DIAGNOSTICS 

Group entries in /etc/group with no login names are flagged. 
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NAME 

ratfor — rational Fortran dialect 
SYNOPSIS 

ratfor [ options ] [ files ] 

DESCRIPTION 

Ratfor converts a rational dialect of Fortran into ordinary irrational For¬ 
tran. Ratfor provides control flow constructs essentially identical to 
those in C: 

statement grouping: 

| statement; statement; statement J 

decision-making: 

if (condition) statement [ else statement ] 
switch (integer value) { 

case integer: statement 

• •• ^ 

[ default: ] statement 

l 

loops: 

while (condition) statement 

for (expression; condition; expression) statement 

do limits statement 

repeat statement [ until (condition) ] 

break 

next 

and some syntactic sugar to make programs easier to read and write: 
free form input: 

multiple statements/line; automatic continuation 

comments: 

# this is a comment. 

translation of relationals: 

>, >=, etc., become .GT., .GE., etc. 

return expression to caller from function: 
return (expression) 

, define: 

define name replacement 

include: 

include file 

The option —h causes quoted strings to be turned into 27H constructs. 
The —C option copies comments to the output and attempts to format it 
neatly. Normally, continuation lines are marked with a & in column 1; 
the option — 6x makes the continuation character x and places it in 
column 6. 

Ratfor is best used with /77(l). 

SEE ALSO 

efl(l), f77(l). 

B. W. Kernighan and P. J. Plauger, Software Tools, Addison-Wesley, 1976. 
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NAME 

reform — reformat text file 
SYNOPSIS 

reform [tabspecl [tabspec2]] [+bn] [+en] [+f] [+in] [+mn] [+pn] [+s] 
[+tn] 

DESCRIPTION 

Reform reads each line of the standard input file, reformats it, and then 
writes it to the standard output. Various combinations of reformatting 
operations can be selected, of which the most common involve rear¬ 
rangement of tab characters. It is often used to trim trailing blanks, 
truncate lines to a specified length, or prepend blanks to lines. 

Reform first scans its arguments, which may be given in any order. It 
then processes its input file, performing the following actions upon each 
line, in the order given: 

— A line is read from the standard input. 

• — If +s is given, all characters up to the first tab are stripped off and 
saved for later addition to the end of the line. Presumably, these 
characters comprise an “SCCS SID” produced by get( 1). 

— The line is expanded into a tabless form, by replacing tabs with blanks 
according to the input tab specification tabspecl. 

— If +pn is given, n blanks are prepended to the line. 

— If- +tn is given, the line is truncated to a length of n characters. 

— All trailing blanks are now removed. 

— If +en is included, the line is extended out with blanks to the length of 
n characters. 

— If +s is given, the previously-saved “SCCS SID” is >added to the end of 
the line. 

— If +bn is given, the n characters at the beginning of the line are con¬ 
verted to blanks, if and only if all of them are either digits or blanks. 

— If +mn is included, the line is moved left, i.e., n characters are remo¬ 
ved from the beginning of the line. 

— The line is now contracted by replacing some blanks with tab charac¬ 
ters according to the list of tabs indicated by the output tab 
specification tabspec2, and is written to the standard output file. 
Option +i controls the method of contraction (see below). 

The various arguments accepted by reform are as follows: 

tabspecl 

describes the tab stops assumed for the input file. This tab 
specification may take on any of the forms described in £abs(l). 
In addition, the operand — indicates that the tab specification 
is to be found in the first line read from the standard input. If 
no legal tab specification is found there, —8 is assumed. If 
tabspecl is omitted entirely, —is assumed. 

tabspec2 

describes the tabs assumed for the output file. It is 
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interpreted in the same way as tabspecl, except that omission 
of tabspec2 causes the value of tabspecl to be used for 
tabspec2. 

The remaining arguments are all optional and may be used in any com¬ 
bination, although only a few combinations make much sense. 
Specifying an argument causes an action to be performed, as opposed 
to the usual default of not performing the action. Some options include 
numeric values, which also have default values. Option actions are 
applied to each line in the order described above. Any line length men¬ 
tioned applies to the length of a line just before the execution of the 
option described, and the terminating new-line is never counted in the 
line length. 

+bn causes the first n characters of a line to be converted to 
blanks, if and only if those characters include only blanks and 
digits. If n is omitted, the default value is 6, which is useful in 
deleting sequence numbers from COBOL programs. 

+en causes each line shorter than » characters to be extended out 
with blanks to that length. Omitting n implies a default value 
of 72. This option is useful for those rare cases in which 
sequence numbers need to be added to an existing unnum¬ 
bered file. The use of S in editor regular expressions is more 
convenient if all lines have equal length, so that the user can 
issue editor commands such as: 
s/SOOOOlOOO/ 

+f causes a format line to be written to the standard output, pre¬ 
ceding any other lines written. See /spec(5) for details regar¬ 
ding format specifications. The format line is taken from 
tabspec2, i.e., the line normally appears as follows: 

<&—tabspec2 d:> 

If tabspec2 is of the form — -file-name (i.e., an indirect reference to a 

tab specification in the first line of the named file), then that tab 

specification line is written to the standard output. 

+in controls the technique used to compress interior blanks into 
tabs. Unless this option is specified, any sequence of 1 or more 
blanks may be converted to a single tab character if that 
sequence occurs just before a tab stop. This causes no prob¬ 
lems for blanks that occur before the first nonblank character 
in a line, and it is always possible to convert the result back to 
an equivalent tabless form. However, occasionally an interior 
blank (one occurring after the first nonblank) is converted to 
a tab when this is not intended. For instance, this might occur 
in any program written in a language utilizing blanks as delimi¬ 
ters. Any single blank might be converted to a tab if it 
occurred just before a tab stop. Insertion or deletion of 
characters preceding such a tab may cause it to be inter¬ 
preted in an unexpected way at a later time. If the +i option is 
used, no string of blanks may be converted to a tab unless 
there are n or more contiguous blanks. The default value is 2. 
Note that leading blanks are always converted to tabs when 
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possible. It is recommended that conversion of programs from 
non -UNIX to UNIX systems use this option. 

+mn causes each line to be moved lift n characters, with a default 
value of 6. This can be useful for crunching COBOL programs. 

+pn causes n blanks to be prepended (default of 6 if n is omitted). 

This option is effectively the inverse of +mn, and is often useful 
for adjusting the position of nrojf(l) output for terminals lack¬ 
ing both forms tractor positioning and a settable left margin. 

+s is used with the —m option of get(i). The —m option causes get 
to prepend to each generated line the appropriate SCCS SID. 
followed by a tab. The +s option causes reform to remove the 
SID from the front of the line, save it, then add it later to the 
end of the line. Because +e72 is implied by this option, the 
effect is to produce 80-character card images with SCCS SID in 
columns 73—80. Up to 8 characters of the SID are shown; if it is 
lqnger, the eighth character is replaced by • and any charac-' 
ters to the right of it are discarded. 

+tn causes any line longer than n characters to be truncated to 
that length. If n is omitted, the length defaults to 72. 
Sequence numbers can thus be removed and any blanks 
immediately preceding them deleted. 

The following illustrate typical uses of reform. The terms PWB and 
OBJECT below refer to UNIX and non- UNIX computer systems, respec¬ 
tively. Each arrow indicates the direction of conversion. The character 
? indicates an arbitrary tab specification; see fa6s(l) for descriptions of 
legal specifications. 

OBJECT-> PWB (i.e., manipulation of RJE output): 

Note that files transferred by RJE from OBJECT to PWB materialize with 
format —8. 

reform —8 —c +t +b +i <oldfile >newfile (into COBOL) 

reform -8 —c3 +t +m +i Coldfile >newfile (into COBOL, crunched) 

NOTE: -c3 is the preferred format COBOL; it uses the least disk space of the 
COBOL formats. 

PWB-> OBJECT (i.e., preparation of files for RJE submission): 

reform ? -8 <oldfile >newfile (from arbitrary format into —8) 
get —p —m sccsfile | reform +s | send ... 

PWB ONLY (i.e., no involvement with other systems): 

pr file | reform ? —0 <oldfile (print on terminal without hardware tabs) 
reform ? —0 <oldfile >newfile (convert file to tabless format) 

DIAGNOSTICS 

All diagnostics are fatal, and the offending line is displayed following the 
message. 

•‘line too long" a line exceeds 512 characters (in tabless form). 

"not SCCS — m” a line does not have at least one tab when +s flag is used. 
Any of the diagnostics of fabs(l) can also appear. 
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EXIT CODES 

0 — normal 
1 — any error 

SEE ALSO 

get(l), nroff(l), send(lC), tabs(l), fspec(5). 

BUGS 

Reform is aware of the meanings of backspaces and escape sequences, so 
that it can be used as a postprocessor for nrojJ. However, be warned 
that the +e, +m. and +t options only count characters, not positions. 
Anyone using these options on output containing backspaces or halfline 
motions will probably obtain unexpected results. 
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NAME 

rsh — restricted shell (command interpreter) 

SYNOPSIS 

rsh [ flags ] [ name [ argl ... ] ] 

DESCRIPTION 

Rsh is a restricted version of the standard command interpreter sA(l). 
It is used to set up login names and execution environments whose capa¬ 
bilities are more controlled than those of the standard shell. The actions 
of rsh are identical to those of sh, except that the following are disal¬ 
lowed: 

cd 

setting the value of SPATH 
command names containing / 

> and » 

When invoked with the name —rsh, rsh reads the user’s .profile (from 
SHOVE/.profile). It acts as the standard sh while doing this, except that 
an interrupt causes an immediate exit, instead of causing a return to 
command level. The restrictions above are enforced after .profile is 
interpreted. 

When a command to be executed is found to be a shell procedure, rsh 
invokes sh to execute it. Thus, it is possible to provide to the end user 
shell procedures that have access to the full power of the standard shell, 
while restricting him to a limited menu of commands: this scheme 
assumes that the end user does not have write and execute permissions 
in the same directory. 

The net effect of these rules is that the writer of the .profile has com¬ 
plete control over user actions, by performing guaranteed setup actions, 
then leaving the user in an appropriate directory (probably not the login 
directory). 

Rsh is actually just a link to sh and any flags arguments are the same as 
for s/i(l). 

The system administrator often sets up a directory of commands that 
can be safely invoked by rsh. Some systems also provide a restricted edi¬ 
tor red. 

SEE ALSO 

sh(l), profile(5). 
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NAME 

rxctrl — floppy disk manipulating program 
SYNOPSIS 

rxctrl —[fsdiz] /dev/rrx? 

DESCRIPTION . 

Rxctrl is used to give commands to the floppy drive: 

—f Initialize data fields according to specified floppy density. See 

KX(4). 

—s Byte swapping 

-d Default: no swap of bytes 

Unusual commands: 

—i Interleave of sectors off. 

—z Zigzag on: sequential blocks on different floppy sides. 

FILES 

/dev/rrx* 

SEE ALSO 

rx(4), format(8), tmctrl(l), dd(l) 
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NAME 

sdiff — side-by-side difference program 
SYNOPSIS 

sdiff [ options ... ] filel file2 
DESCRIPTION 

Sdiff uses the output of diff(l) to produce a side-by-side listing of two 
files indicating those lines that are different. Each line of the two files is 
printed with a blank gutter between them if the lines are identical, a < in 
the gutter if the line only exists in file 1 , a > in the gutter if the line only 
exists in file2, and a | for lines that are different. 

For example: 

x | y 

a a 

b < 

c < 

d d 

> c 

The following options exist: 

—w n Use the next argument, n, as the width of the output line. The 

default line length is 130 characters. 

—1 Only print the left side of any lines that are identical. 

—s Do not print identical lines. 

—o output 

Use the next argument, output, as the name of a third file that 
is created as a user controlled merging of filel and file2. Iden¬ 
tical lines of filel and file2 are copied to output. Sets of 
differences, as produced by diff(l), are printed: where a set of 
differences share a common gutter character. After printing 
each set of differences, sdiff prompts the user with a % and 
waits for one of the following user-typed commands: 

1 append the left column to the output file 
r append the right column to the output file 

s turn on silent mode; do not print identical lines 

▼ turn off silent mode 

e 1 call the editor with the left column 

e r call the editor with the right column 

e b call the editor with the concatenation of left and 
right 

e call the editor with a zero length file 
q exit from the program 

On exit from the editor, the resulting file is concatenated on 
the end of the output file. 
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SEE ALSO 

diff(l). ed(l). 
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NAME 

sh - shell, the standard command programming language 
SYNOPSIS 

sh [ —ceiknrstuvx ] [ args ] 

DESCRIPTION 

57i is a command programming language that executes commands read 
from a terminal or a file. See Invocation below for the meaning of 
arguments to the shell. 

Commands. 

A simple-command is a sequence of non-blank words separated by 
blanks (a blank is a tab or a space). The first word specifies the name of 
the command to be executed. Except as specified below, the remaining 
words are passed as arguments to the invoked command. The command 
name is passed as argument 0 (see exec(2)). The value of a simple- 
command is its exit status if it terminates normally, or (octal) 200+sfa- 
tus if it terminates abnormally (see signal (2) for a list of status values). 

A pipeline is a sequence of one or more commands separated by |. The 
standard output of each command but the last is connected by a pipe(2) 
to the standard input of the next command. Each command is run as a 
separate process; the shell waits for the last command to terminate. 

A list is a sequence of one or more pipelines separated by ;, Sc, tele , or ||, 
and optionally terminated by ; or It. Of these four symbols, ; and It have 
equal precedence, which is lower than that of tele and ||. The symbols tele 
and || also have equal precedence. A semicolon (;) causes sequential exe¬ 
cution of the preceding pipeline; an ampersand (&) causes asynchronous 
execution of the preceding pipeline (i.e., the shell does not wait for that 
pipeline to finish). The symbol tele (||) causes the list following it to be 
executed only if the preceding pipeline returns a zero (non-zero) exit 
status. An arbitrary number of new-lines may appear in a list, instead of 
semicolons, to delimit commands. 

A command is either a simple-command or one of the following. Unless 
otherwise stated, the value returned by a command is that of the last 
simple-command executed in the command. 

for name [ in word ... ] do list done 

Each time a for command is executed, name is set to the next 
word taken from the in word list. If in word ... is omitted, then 
the for command executes the do list once for each positional 
parameter that is set (see Parameter Substitution below). Execu¬ 
tion ends when there are no more words in the list, 
case word in [ pattern [ | pattern ] ... ) list ;:]... esac 

A case command executes the list associated with the first pattern 
that matches word. The form of the patterns is the same as that 
used for file-name generation (see FUe Name Generation below), 
if list then list [ elif list then list ] ... [ else list ] fi 

The list following if is executed and, if it returns a zero exit status, 
the list following the first then is executed. Otherwise, the list fol¬ 
lowing elif is executed and, if its value is zero, the list following 
the next then is executed. Failing that, the else list is executed. 
If no else list or then list is executed, then the if command 
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returns a zero exit status, 
while list do list done 

A while command repeatedly executes the while list and, if the exit 
status of the last command in the list is zero, executes the do list ; 
otherwise the loop terminates. If no commands in the do list are 
executed, then the while command returns a zero exit status; until 
may be used in place of while to negate the loop termination test. 

(list) 

Execute list in a sub-shell. 
list is simply executed. 

The following words are only recognized as the first word of a command 
and when not quoted: 

if then else elif fi case esac for while until do done ( j 
Comments. 

A word beginning with # causes that word said all the following characters 
up to a new-line to be ignored. 

Command Substitution. 

The standard output from a command enclosed in a pair of grave accents 
(") may be used as part or all of a word; trailing new-lines are removed. 

Parameter Substitution. 

The character S is used to introduce substitutable parameters. Posi¬ 
tional parameters may be assigned values by set. Variables may be set 
by writing: • 

name rvalue [ name =value ] ... 

Pattern-matching is not performed on value. 

%\parameter\ 

A parameter is a sequence of letters, digits, or underscores (a 
name), a digit, or any of the characters *, @, #, ?. —, S, and !. The 
value, if any, of the parameter is substituted. The braces are 
required only when parameter is followed by a letter, digit, or 
underscore that is not to be interpreted as part of its name. A 
name must begin with a letter or underscore. If parameter is a 
digit then it is a positional parameter. If parameter is • or then 
all the positional parameters, starting with SI, are substituted 
(separated by spaces). Parameter SO is set from argument zero 
when the shell is invoked. 
t\paramet er :—word { 

If parameter is set and is non-null then substitute its value; oth¬ 
erwise substitute word. 

\\parameterv=word { 

If parameter is not set or is null then set it to word; the value of 
the parameter is then substituted. Positional parameters may not 
be assigned to in this way. 

S\paramet er-.lword j 

If parameter is set and is non-null then substitute its value; oth¬ 
erwise, print word and exit from the shell. If word is omitted, then 
the message "parameter null or not set" is printed. 
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S [parameter :+word j 

If parameter is set and is non-null then substitute word] otherwise 
substitute nothing. 

In the above, word is not evaluated unless it is to be used as the substitu¬ 
ted string, so that, in the following example, pwd is executed only if d is 
not set or is null: 

echo S[d:—'pwd'j 

If the colon (:) is omitted from the above expressions, then the shell only 
checks whether parameter is set or not. 

The following parameters are automatically set by the shell: 

| The number of positional parameters in decimal. 

— Flags supplied to the shell on invocation or by the set com¬ 
mand. 

? The decimal value returned by the last synchronously exe¬ 
cuted command. 

S The process number of this shell. 

! The process number of the last background command 
invoked. 

The following parameters are used by the shell: 

HOIIE The default argument (home directory) for the cd com¬ 
mand. 

PATH The search path for commands (see Execution below). 

UA1L If this variable is set to the name of a mail file, then the 
shell informs the user of the arrival of mail in the specified 
file. 

PS1 Primary prompt string, by default **S ". 

PS2 Secondary prompt string, by default **> ”. 

IFS Internal field separators, normally space, tab, and new-line. 

The shell gives default values to PATH, PS1, PS2, and IFS, while HOUE and 
HAIL are not set at all by the shell (although HOME is set by login(l)). 

Blank Interpretation. 

After parameter and command substitution, the results of substitution 
are scanned for internal field separator characters (those found in IFS) 
and split into distinct arguments where such characters are found. 
Explicit null arguments ("" or ") are retained. Implicit null arguments 
(those resulting from parameters that have no values) are removed. 

File Name Generation. 

Following substitution, each command word is scanned for the charac¬ 
ters *, ?, and [. If one of these characters appears then the word is 
regarded as a pattern. The word is replaced with alphabetically sorted 
file names that match the pattern. If no file name is found that matches 
the pattern, then the word is left unchanged. The character . at the 
start of a file name or immediately following a /, as well as the character 
/ itself, must be matched explicitly. 

• Matches any string, including the null string. 

? Matches any single character. 

[...] Matches any one of the enclosed characters. A pair of 
characters separated by — matches any character lexically 
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execution of a command contains the file descriptors of the invoking 
shell as modified by input/output specifications. 

Environment. 

The environment (see environ (7)) is a list of name-value pairs that is 
passed to an executed program in the same way as a normal argument 
list. The shell interacts with the environment in several ways. On invoca¬ 
tion, the shell scans the environment and creates a parameter for each 
name found, giving it the corresponding value. Executed commands 
inherit the same environment. If the user modifies the values of these 
parameters or creates new ones, none of these affects the environment 
unless the export command is used to bind the shell’s parameter to the 
environment. The environment seen by any executed command is thus 
composed of any unmodified name-value pairs originally inherited by the 
shell, plus any modifications or additions, all of which must be noted in 
export commands. 

The environment for any simple-command, may be augmented by 
prefixing it with one or more assignments to parameters. Thus: 

TERM=450 cmd args and 

(export TERM; TERM=450; cmd args) 

are equivalent (as far as the above execution of cmd is concerned). 

If the —k flag is set, all keyword arguments are placed in the environ¬ 
ment, even if they occur after the command name. The following first 
prints a=b c and then c: 

echo a=b c . 

set —k 
echo a=b c 

Signals. 

The INTERRUPT and QUIT signals for an invoked command are ignored if 
the command is followed by ic ; otherwise signals have the values inheri¬ 
ted by the shell from its parent, with the exception of signal 11 (but see 
also the trap command below). 

Execution. 

Each time a command is executed, the above substitutions are carried 
out. Except for the Special Commands listed below, a new process is 
created and an attempt is made to execute the command via exec (2). 

The shell parameter PATH defines the search path for the directory con¬ 
taining the command. Alternative directory names are separated by a 
colon (:). The default path is :/bin:/usr/bin (specifying the current 
directory, /bin, and /usr/bin, in that order). Note that the current 
directory is specified by a null path name, which can appear immediately 
after the equal sign or between the colon delimiters anywhere else in the 
path list. If the command name contains a / then the search path is not 
used. Otherwise, each directory in the path is searched for an executa¬ 
ble file. If the file has execute permission but is not an a.out file, it is 
assumed to be a file containing shell commands. A sub-shell (i.e., a 
separate process) is spawned to read it. A parenthesized command is 
also executed in a sub-shell. 
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Special Commands. 

The following commands are executed in the shell process and, except as 
specified, no input/output redirection is permitted for such commands: 

: No effect; the command does nothing. A zero exit code is retur¬ 

ned. 

. file Read and execute commands from file and return. The search 
path specified by PATH is used to find the directory containing file. 
break [ n ] 

Exit from the enclosing for or while loop, if any. If n is specified 
then break n levels, 
continue [ n ] 

Resume the next iteration of the enclosing for or while loop. If n 
is specified then resume at the n-th enclosing loop, 
cd [ arg ] 

Change the current directory to arg. The shell parameter HOIIE is 
the default arg. 
eval [ arg ... ] 

The arguments are read as input to the shell and the resulting 
command(s) executed, 
exec [ arg ... ] 

The command specified by the arguments is executed in place of 
this shell without creating a new process. Input/output 
arguments may appear and, if no other arguments are given, 
cause the shell input/output to be modified. 
exit[ n ] 

Causes a shell to exit with the exit status specified by n. If n is 
omitted then the exit status is that of the last command executed 
(an end-of-file will also cause the shell to exit.) 
export [ name ... ] 

The given names are marked for automatic export to the environ¬ 
ment of subsequently-executed commands. If no arguments are 
given, then a list of all names that are exported in this shell is 
printed. 

newgrp [ arg ... ] 

Equivalent to exec newgrp arg - 

read [ name ... ] 

One line is read from the standard input and the first word is 
assigned to the first name, the second word to the second name, 
etc., with leftover words assigned to the last name. The return 
code is 0 unless an end-of-file is encountered, 
readonly [ name ... ] 

The given names are marked readonly and the values of the these 
names may not be changed by subsequent assignment. If no 
arguments are given, then a list of all readonly names is printed, 
set [ —ekntuvx [ arg ... ] ] 

—e If the shell is non-interactive then exit immediately if a 

command exits with a non-zero exit status. 

—k All keyword arguments are placed in the environment for a 

command, not just those that precede the command name, 
—n Read commands but do not execute them. 
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—t Exit after reading and executing one command. 

—u Treat unset variables as an error when substituting. 

—▼ Print shell input lines as they are read. 

—x Print commands and their arguments as they are executed. 

— Do not change any of the flags; useful in setting SI to -. 

Using + rather than — causes these flags to be turned off. These 
flags can also be used upon invocation of the shell. The current 
set of flags may be found in %—. The remaining arguments are 
positional parameters and are assigned, in order, to SI, S2, — If 
no arguments are given then the values of all names are printed. 

shift 

The positional parameters from S2 .. . are renamed SI .... 

test 

Evaluate conditional expressions. See test(l) for usage and 
description. 

times 

Print the accumulated user and system times for processes run 
from the shell, 
trap [ arg ] [ n ] ... 

arg is a command to be read and executed when the shell receives 
signal(s) n. (Note that arg is scanned once when the trap is set 
and once when the trap is taken.) Trap commands are executed in 
order of signal number. Any attempt to set a trap on a signal that 
was ignored on entry to the current shell is ineffective. An 
attempt to trap on signal 11 (memory fault) produces an error. If 
arg is absent then all trap(s) n are reset to their original values. 
If arg is the null string then this signal is ignored by the shell and 
by the commands it invokes. If n is 0 then the command arg is 
executed on exit from the shell. The trap command with no 
arguments prints a list of commands associated with each signal 
number, 
umask [ nnn ] 

The user file-creation mask is set to nnn (see umask( 2)). If nnn is 
omitted, the current value of the mask is printed, 
wait Wait for all child processes to terminate report the termination 
status. If n is not given then all currently active child processes 
are waited for. The return code from this command is always zero. 

Invocation. 

If the shell is invoked through exec (2) and the first character of 
argument zero is —, commands are initially read from /etc/profile and 
then from SHOUE/.profile, if such files exist. Thereafter, commands are 
read as described below, which is also the case when the shell is invoked 
as /bin/sh. The flags below are interpreted by the shell on invocation 
only; Note that unless the —c or —s flag is specified, the first argument is 
assumed to be the name of a file containing commands, and the 
remaining arguments are passed as positional parameters to that com¬ 
mand file: 

—c string 

If the —c flag is present then commands are read from string. 

—s If the —s flag is present or if no arguments remain then com¬ 

mands are read from the standard input. Any remaining 
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arguments specify the positional parameters. Shell output is 
written to file descriptor 2. 

—i If the —i flag is present or if the shell input and output are atta¬ 

ched to a terminal, then this shell is interactive. In this case 
TERMINATE is ignored (so that kill 0 does not kill an interactive 
shell) and INTERRUPT is caught and ignored (so that wait is 
interruptible). In all cases, QUIT is ignored by the shell. 

—r If the —r flag is present the shell is a restricted shell (see 

rs/t(l)). 

The remaining flags and arguments are described under the set com¬ 
mand above. 


EXIT STATUS 

Errors detected by the shell, such as syntax errors, cause the shell to 
return a non-zero exit status. If the shell is being used non-interactively 
then execution of the shell file is abandoned. Otherwise, the shell 
returns the exit status of the last command executed (see also the exit 
command above). 


FILES 

/etc/profile 
SHO ME /.profile ' 

/tmp/sh« 

/dev/null 

SEE ALSO 

cd(l), env(l), login(l), newgrp(l), rsh(l), test(l), umask(l), dup(2), 
exec(2), fork(2), pipe(2). signal(2), umask(2). wait(2). a.out(5), profile(5), 
environ(7). 


BUGS 



The command readonly (without arguments) produces the same output 
as the command export. 

If « is used to provide standard input to an asynchronous process 
invoked by tc, the shell gets mixed up about naming the input document; 
a garbage file /tmp/sh* is created and the shell complains about not 
being able to find that file by another name. 


c 
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NAME 

size — size of an object file 

SYNOPSIS 

size [ object ... ] 

DESCRIPTION 

Size prints the (decimal) number of bytes required by the text, data, bss 
and stack portions, and their sum in octal and decimal, of each object- 
file argument. If no file is specified, a.out is used. 

SEE ALSO 

a.out(5) 
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NAME 

stctrl — special streamer features 
stskip — skip files 

SYNOPSIS 

stctrl [—e] [—r] 
stskip count 

DESCRIPTION 

Stctrl is used to execute special streamer commands. The possible 
options; are: 

—e to erase the whole tape. 

—r to make a retension of the tape. 

Stskip skips the next files on the tape. Count holds the number of files to 
be skipped. 

These two commands always refer to streamer drive 0. 

FILES 

/dev/rstO 

/dev/nrstO 

SEE ALSO 
st(4) 
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NAME 

strip — remove symbols and relocation bits 

SYNOPSIS 

strip name ... 

DESCRIPTION 

Strip removes the symbol table and relocation bits ordinarily attached to 
the output of the assembler and link editor. This is useful to save space 
after a program has been debugged. 

The effect of strip is the same as use of the —s option of Id. 

If name is an archive file, strip will remove the local symbols from any 
a .out format files it finds in the archive. Certain libraries, such as those 
residing in /lib, have no need for local symbols. By deleting them, the 
size of the archive is decreased and link editing performance is 
increased. 

FILES 

/tmp/stm* temporary file 

SEE ALSO 

ld(l). 
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NAME 

stty — set terminal options of the current output terminal 
setty — set terminal options of an other output terminal 

SYNOPSIS 

stty [ option ... ] 
setty special [ option ... ] 

DESCRIPTION 

Stty sets certain I/O options on the current output terminal. 

Setty does the same for the terminal named special. 

With no argument, they report the current settings of the options. The 
option strings are selected from the following set: 

even allow even parity 
—even disallow even parity 
odd allow odd parity 
—odd disallow odd parity 

raw raw mode input (no erase, kill, interrupt, quit, EOT; parity bit 
passed back) 

—raw negate raw mode 
cooked 

same as ’—raw’ 

cbreakmake each character available to read(2) as received; no erase 
and kill 
—cbreak 

make characters available to read only when newline is received 
—nl allow carriage return for new-line, and output CR-LF for carriage 

return or new-line 

nl accept only new-line to end lines 
echo echo back every character typed 
—echo do not echo characters 
lease map upper case to lower case 
—lease do not map case 

—tabs replace tabs by spaces when printing 
tabs preserve tabs 

ek reset erase and kill characters back to normal # and @ 
erase c 

set erase character to c. Ccan be of the form '~X' which is inter¬ 
preted as a ‘control X’. 

kill c set kill character to c. '~X ‘works here also. 
crO crl cr2 cr3 

select style of delay for carriage return (see ioctl{2)) 
nlO nil nl2 nl3 

select style of delay for linefeed 
tabO tabl tab2 Lab3 

select style of delay for tab 
ffO ff 1 select style of delay for form feed 
bsO bsl 

select style of delay for backspace 

tty33 set all modes suitable for the Teletype Corporation Model 33 ter¬ 
minal. 

tty37 set all modes suitable for the Teletype Corporation Model 37 ter¬ 
minal. 
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yt05 set all modes suitable for Digital Equipment Corp. VT05 terminal 
tn300 set all modes suitable for a General Electric TermiNet 300 
ti700 set all modes suitable for Texas Instruments 700 series terminal 
tek set all modes suitable for Tektronix 4014 terminal 
hup hang up dataphone on last close. 

—hup do not hang up dataphone on last close. 

0 hang up phone line immediately 

50 75 110 134 150 200 300 600 1200 1800 2400 4800 9600 exta extb 

Set terminal baud rate to the number given, if possible. (These 
are the speeds supported by the DH-11 interface). 

SEE ALSO 

ioctl(2), tabs(l) 
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NAME 

tbl — format tables for nroff or troff 
SYNOPSIS 

tbl [ -TX ] [ files ] 

DESCRIPTION 

Tbl is a preprocessor that formats tables for nrojf (l) or troff { 1). The 
input files are copied to the standard output, except for lines between .TS 
and .TE command lines, which are assumed to describe tables and are 
re-formatted by tbl. (The .TS and .TE command lines are not altered by 
tbl). 

.TS is followed by global options. The available global options are: 

center center the table (default is left-adjust); 
expand make the table as wide as the current line length; 
box enclose the table in a box; 
doublebox 

enclose the table in a double box; 
allbox enclose each item of the table in a box; 
tab ( x ) use the character z instead of a tab to separate items in 
a line of input data. 

The global options, if any, are terminated with a semi-colon (;). 

Next come lines describing the format of each line of the table. Each 
such format line describes one line of the actual table, except that the 
last format line (which must end with a period) describes all remaining 
lines of the table. Each column of each line of the table is described by a 
single key-letter, optionally followed by specifiers that determine the 
font and point size of the corresponding item, that indicate where verti¬ 
cal bars are to appear between columns, that determine column width, 
inter-column spacing, etc. The available key-letters are: 

c center item within the column; 
r right-adjust item within the column; 

1 left-adjust item within the column; 

n numerically adjust item in the column: units positions of 
numbers are aligned vertically; 

8 span previous item on the left into this column; 
a center longest line in this column and then left-adjust all 
other lines in this column with respect to that centered 
line; 

span down previous entry in this column; 

_ replace this entry with a horizontal line; 

= replace this entry with a double horizontal line. 

The characters B and I stand for the bold and italic fonts, respectively; 
the character | indicates a vertical line between columns. 

The format lines are followed by lines containing the actual data for the 
table, followed finally by .TE. Within such data lines, data items are nor¬ 
mally separated by tab characters. 

If a data line consists of only _ or =, a single or double line, respectively, 
is drawn across the table at that point; if a single item in a data line con¬ 
sists of only _ or =, then that item is replaced by a single or double line. 
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Full details of all these and other features of tbl are given in the 
reference manual cited below. 

The -TX option forces tbl to use only full vertical line motions, making 
the output more suitable for devices that cannot generate partial verti¬ 
cal line motions (e.g., line printers). 

If no file names are given as arguments, tbl reads the standard input, so 
it may be used as a filter. When it is used with egn(l) or negn(l), tbl 
should come first to minimize the volume of data passed through pipes. 

EXAMPLE 

If we let -* represent a tab (which should be typed as a genuine tab), then 
the input: 

.TS 

center box ; 
cB s s 
cl | cl s 
~ | c c 
1 | n n . 

Household Population 

Town-*Households 

-*Number-*Size 

Bedminster-*789-*3.26 
Bernards Twp.-*3087-*3.74 
Bemardsville-*20l8-*3.30 
Bound Brook-*3425-*3.04 
Bridgewater-*7897-*3.81 
Far Hills-*240-*3.19 
.TE 

yields: 


Household Population 


Town 

Households 
Number Size 

Bedminster 

789 

3.26 

Bernards Twp. 

3087 

3.74 

Bemardsville 

2018 

3.30 

Bound Brook 

3425 

3.04 

Bridgewater 

7897 

3.81 

Far Hills 

240 

3.19 


SEE ALSO 

TBL-A Program to fbrmat Tobias by M. E. Lesk 
eqn(l), mm(l), mmt(l), trofl(l), mm(7), mv(7). 

BUGS 

See BUGS under trojf{ 1). 
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NAME 

tmctrl — magnetic tape manipulating program 
tmskip — skip files 

SYNOPSIS 

tmctrl —[sd] [tapename] 
tmskip count 

DESCRIPTION 

Tmctrl is used to give commands to the tape drive. If no tapename is 
specified, /dev/rmtO is used. 

Here are the commands: 

—s byte swapping 

—d default: no swap of bytes 

Tmskip skips the next count files of the tape. 

FILES 

/dev/rmt* /dev/nrmt* Raw magnetic tape interface 

SEE ALSO 

tm(4) 
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NAME 

tplot — graphics filters 
SYNOPSIS 

tplot [ —Tterminal [ —e raster ] ] 

DESCRIPTION 

These commands read plotting instructions (see pZo<(5)) from the stan¬ 
dard input and in general produce, on the standard output, plotting 
instructions suitable for a particular terminal. If no terminal is 
specified, the environment parameter STERM (see environ(7)) is used. 
Known terminals are: 

300 DASI300. 

300S DASI 300s. 

450 DASI 450. 

4014 Tektronix 4014. 

lbp Canon lbplO laserbeam printer 

ver Versatec D1200A. This version of plot places a scan-converted 
image in /usr/tmp/rasterSS and sends the result directly to the 
plotter device, rather than to the standard output. The —e option 
causes a previously scan-converted file raster to be sent to the 
plotter. 

FILES 

/usr/lib/t300 

/usr/lib/t300s 

/usr/lib/t450 

/usr/lib/t4014 

/usr/lib/lplot 

/usr/lib/vplot 

/usr/tmp/rasterSS 

SEE ALSO 

plot(3X), plot(5), term(7). 
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NAME 


troff. nroff — typeset or format text 


SYNOPSIS 

nroff [ options ] [ files ] 
troff [ options ] [ files ] 

DESCRIPTION 

Nroff formats text contained in files (standard input by default) for prin¬ 
ting on typewriter-like devices and line printers; similarly, troff formats 
text for a Wang Laboratories, Inc., C/A/T photo typesetter. Their capabil¬ 
ities are described in the NROFF/TROFF User’s Manual cited below. 

An argument consisting of a minus (—) is taken to be a file name 
corresponding to the standard input. The options, which may appear in 
any order, but must appear before the files, are: 

—o list Print only pages whose page numbers appear in the list of 

numbers and ranges, separated by commas. A range N—M 
means pages N through M\ an initial —N means from the begin¬ 
ning to page N\ and a final N— means from N to the end. (See 
BUGS below.) 

—n N Number first generated page N. 

sN Stop every N pages. Nroff will halt after every N pages (default 
N= 1) to allow paper loading or changing, and will resume upon 
receipt of a line-feed or new-line (new-lines do not work in 
pipelines, e.g., with mm(l)). This option does not work if the 
output of nroff is piped through co£(l). Troff will stop the pho¬ 
totypesetter every N pages, produce a trailer to allow changing 
cassettes, and resume when the typesetter’s start button is 
pressed. When nroff {troff) halts between pages, an ASCII BEL 
(in troff, the message page stop) is sent to the terminal. 

—r aN Set register a (which must have a one-character name) to N. 

—i Read standard input after files are exhausted. 

-q Invoke the simultaneous input-output mode of the .rd request. 

—x Print only messages generated by .tm (terminal message) 

requests. 

— umame Prepend to the input files the non-compacted (ASCII text) 
macro file /usr/lib/tmac/tniac.name. 

—cname Prepend to the input files the compacted macro files 
/usr/lib/macros/cmp.[nt]. dtj.name and 

/usr/lib/macros/ucmp.[nt].name. 

—k name Compact the macros used in this invocation of nroff /troff , pla¬ 
cing the output in files [dtj.name in the current directory (see 
the May 1979 Addendum to the NROFF/TROFF User’s Manual 
for details of compacting macro files). 


Nroff only: 
—Tname 


Prepare output for specified terminal. Known names are 37 
for the (default) TELETYPE* Model 37 terminal, tn300 for the GE 
TermiNet 300 (or any terminal without half-line capability), 
300s for the DASI 300s, 300 for the DASI 300, 450 for the DASI 
450, lp for a (generic) ASCII line printer, 382 for the DTC-382. 
4000A for the Trendata 4000A, 832 for the Anderson Jacobson 
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832. X for a (generic) EBCDIC printer, and 2631 for the Hewlett 
Packard 2631 line printer. 

— e Produce equally-spaced words in adjusted lines, using the full 

resolution of the particular terminal. 

—h Use output tabs during horizontal spacing to speed output and 

reduce output character count. Tab settings are assumed to 
be every 8 nominal character widths. 

—un Set the emboldening factor (number of character overstrikes) 

for the third font position (bold) to n, or to zero if n is missing. 


Troff only: 
-t 



-P # 


—T name 


Direct output to the standard output instead of the photo- 
typesetter. 

Refrain from feeding out paper and stopping phototypesetter 
at the end of the run. 

Wait until phototypesetter is available, if it is currently busy. 
Report whether the phototypesetter is busy or available. No 
text processing is done. 

Send a printable ASCII approximation of the results to the stan¬ 
dard output. 

Print all characters in point size N while retaining all prescri¬ 
bed spacings and motions, to reduce phototypesetter elapsed 
time. 

Prepare output for the Murray Hill Computation Center photo¬ 
typesetter and direct it to the standard output (see grcaf(lC)). 
This option is not compatible with, the —s option; furthermore, 
when this option is invoked, all .fp (font position) requests (if 
any) in the troff input must come before the first break, and 
no .tl requests may come before the first break. 

Use font-width tables for device name (the font tables are 
found in /usr/lib/font/name/*). Currently, no names are 
supported. 


suffix hyphenation tables 
temporary file 

standard macro files and pointers 
standard macro files 
terminal driving tables for nroff 
font width tables for troff 

SEE ALSO 

NROFF /TROFF User’s Manual by J. F. Ossanna. 

A TROFF Tutorial by B. W. Kemighan. 
eqn(l), tbl(l). mm(7). 
col(l), greek(l), mm(l) {nroff only). 
gcat(lC), mmt(l), tc(l), mv(7) {troff only). 

BUGS 

Nroff /troff believes in Eastern Standard Time; as a result, depending on 
the time of the year and on your local time zone, the date that 
nroff /troff generates may be off by one day from your idea of what the 
date is. 

When nroff /troff is used with the —olist option inside a pipeline (e.g.. 


FILES 


/usr/lib/suftab 

/tmp/taS# 

/usr / lib / tmac / tmac. • 
/usr/lib/macros/* 
/usr/lib/term/* 
/usr/lib/font/ • 
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with one or more of ciu(l), eqrn(l), and f6f(l)) t it may cause a harmless 
"broken pipe" diagnostic if the last page of the document is not specified 
in list. 
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NAME 

uname — print name of current UNIX 

SYNOPSIS 

uname [ —snrva ] 

DESCRIPTION 

Uname prints the current system name of UNIX on the standard output 
file. It is mainly useful to determine what system one is using. The 
options cause selected information returned by uname ( 2) to be printed: 

—s print the system name (default). 

—n print the nodename (the nodename may be a name that the sys¬ 

tem is known by to a communications network). 

—r print the operating system release. 

—v print the operating system version. 

—a print all the above information. 

SEE ALSO 

uname(2). 
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NAME 

uuclean — uucp spool directory clean-up 
SYNOPSIS 

uuclean [ options ] ... 

DESCRIPTION 

Uuclean will scan the spool directory for files with the specified prefix 
and delete all those which are older than the specified number of hours. 

The following options are available. 

—d directory 

Clean directory instead of the spool directory. 

—ppre Scan for files with pre as the file prefix. Up to 10 —p arguments 
may be specified. A —p without any pre following will cause all 
files older than the specified time to be deleted. 

—n time 

Files whose age is more than time hours will be deleted if the 
prefix test is satisfied, (default time is 72 hours) 

—m Send mail to the owner of the file when it is deleted. 

This program will typically be started by cron(lM). 

FILES 

/usr/lib/uucp 

directory with commands used by uuclean internally 
/lisr/spool/uucp 

spool directory 

SEE ALSO 

uucp(lC), uux(lC). 
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NAME 

uucp, uulog, uuname — Unix to unix copy 
SYNOPSIS 

uucp [ option ] ... source-file ... destination-file 
uulog [ option ] ... 
uuname 
DESCRIPTION 

Uucp copies files named by the source-file arguments to the 
destination-file argument. A file name may be a path name on your 
machine, or may have the form: 

system-name!path-name 

where system-name is taken from a list of system names which uucp 
knows about. Shell metacharacters ?•[] appearing in path-name will be 
expanded on the appropriate system. 

Path names may be one of: 

(1) a full path name; 

(2) a path name preceded by ~user where user is a login name on the 
specified system and is replaced by that user’s login directory; 

(3) a path name preceded by ~/t iser where user is a login name on 
the specified system and is replaced by that user’s directory 
under PUBDIR; 

(4) anything else is prefixed by the current directory. 

If the result is an erroneous path name for the remote system the copy 
will fail. If the destination-file is a directory, the last part of the source- 
file name is used. 

Uucp preserves execute permissions across the transmission and gives 
0666 read and write permissions (see chmod(2)).' 

The following options are interpreted by uucp: 

—d Make all necessary directories for the file copy (default). 

—f Do not make intermediate directories for the file copy. 

—c Use the source file when copying out rather than copying the file to 
the spool directory (default). 

—C Copy the source file to the spool directory. 

—m Send mail to the requester when the copy is complete. 

—miser 

Notify user on the remote system that a file was sent. 

—esys 

Send the uucp command to system sys to be executed there. (Note 
— this will only be successful if the remote machine allows the uucp 
command to be executed by /usr/lib/uucp/uuxqt.) 

Uulog maintains a summary log of uucp and uux(lC) transactions in the 
file /usr/spool/uucp/LOGFILE by gathering information from partial log 
files named /usr/spool/uucp/LOG.*.?. (These files will only be created if 
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the LOGFILE is being used by another process.) It removes the partial log 
files. 

The options cause uulog to print logging information: 

-s sys 

Print information about work involving system sys. 

—u user 

Print information about work done for the specified user. 

Uuname lists the uucp names of known systems. The —1 option returns 
the local system name. 

FILES 

/usr/spool/uucp 

spool directory 
/usr / spool / uucppublic 

public directory for receiving and sending (PUBDIR) 
/usr/lib/uucp/» 

other data and program files 

SEE ALSO 

mail(l), uux(lC). 

Uucp Implementation Description by D. A. Nowitz. 

WARNING 

The domain of remotely accessible files caii (and for obvious security 
reasons, usually should) be severely restricted. You will very likely not 
be able to fetch files by path name; ask a responsible person on the 
remote system to send them to you. For the same reasons you will pro¬ 
bably not be able to send files to arbitrary path names. As distributed, 
the remotely accessible files are those whose names begin 
/usr/spool/uucppublic (equivalent to ~nuucp or just ~). 

BUGS 

All files received by uucp will be^owned by uucp. 

The —m option will only work sending files or receiving a single file. 
(Receiving multiple files specified by special shell characters ?*[] will not 
activate the —m option.) 
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NAME 

uustat — uucp status inquiry and job control 
SYNOPSIS 

uustat [ option ] ... 


DESCRIPTION 

Uustat will display the status of, or cancel, previously specified uucp 
commands, or provide general status on uucp connections to other sys¬ 
tems. The following options are recognized: 

—Tamch Report the status of accessibility of machine mch. If inch, is 
specified as all, then the status of all machines known to the 
local uucp are provided. 

—Ixjobn Kill the uucp request whose job number is jobn. The killed uucp 
request must belong to the person issuing the uustat command 
unless he is the super-user. 

—chour Remove the status entries which are older than hour hours. 

This administrative option can only be initiated by the user 
uucp or the super-user. 

— uuser Report the status of all uucp requests issued by user. 

—ssys Report the status of all uucp requests which communicate with 
remote system sys. 

—ohour Report the status of all uucp requests which are older than 
hour hours. 

—yhour Report the status of all uucp requests which are younger than 
hour hours. 

—j all Report the status of all the uucp requests. 

—v Report the uucp status verbosely. If this option is not specified, 

a status code is printed with each uucp request. 

When no options are given, uustat outputs the status of all uucp requests 
issued by the current user. Note that only one of the options —j, —m, —k, 
—c, or the rest of other options may be specified. 

For example, the command 

uustat —uhdc — smhtsa —y72 —v 

will print the verbose status of all uucp requests that were issued by user 
hdc to communicate with system mhtsa within the last 72 hours. The 
meanings of the job request status are: 

job-number user remote-system command-time status-time status 

where the status may be either an octal number or a verbose descrip¬ 
tion. The octal code corresponds to the following description: 


OCTAL STATUS 

00001 the copy failed, but the reason cannot be determined 

00002 permission to access local file is denied 

00004 permission to access remote file is denied 

00010 bad uucp command is generated 

00020 remote system cannot create temporary file 

00040 cannot copy to remote directory 

00100 cannot copy to local directory 

00200 local system cannot create temporary file 
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00400 cannot execute uucp 
01000 copy succeeded 

02000 copy finished, job deleted 

04000 job is queued 

The meanings of the machine accessibility status are: 
system-name time status 

where time is the latest status time and status is a self-explanatory 
description of the machine status. 

FILES 

/usr / spool / uucp 

spool directory 
/usr/lib/uucp/I<_stat 

system status file 
/usr / lib / uucp / R_jstat 

request status file 

SEE ALSO 

uucp(lC). 

Uustat — A UUCP Status Inquiry Program, by H. Che. 
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NAME 

uusub — monitor uucp network 

SYNOPSIS 

uusub [ options ] 

DESCRIPTION 

Uusub defines a uucp subnetwork and monitors the connection and 
traffic among the members of the subnetwork. The following options are 
available: 

—a sys Add sys to the subnetwork. 

—dsys Delete sys from the subnetwork. 

—1 Report the statistics on connections. 

—r Report the statistics on traffic amount. 

—f Flush the connection statistics. 

—uhr Gather the traffic statistics over the past hr hours. 

—c sys Exercise the connection to the system sys. If sys is specified as^ 
all, then exercise the connection to all the systems in the sub-" 
network. 

The meanings of the connections report are: 

sys #call #ok time #dev #login #nack #other 

where sys is the remote system name, ffcall is the number of times the 
local system tries to call sys since the last flush was done, #ok is the 
number of successful connections, time is the the latest successful con¬ 
nect time, #dev is the number of unsuccessful connections because of no 
available device (e.g. ACU), #login is the number of unsuccessful connec¬ 
tions because of login failure, #nacJb is the number of unsuccessful con¬ 
nections because of no response (e.g. line busy, system down), and #other 
is the number of unsuccessful connections because of other reasons. 

The meanings of the traffic statistics are: 

sfile sbyte rfile rbyte 

where sfile is the number of files sent and sbyte is the number of bytes 
sent over the period of time indicated in the latest uusub command with 
the —u hr option. Similarly, rfile and rbyte are the numbers of files and 
bytes received. 

The command: 

uusub —c all —u 24 

is typically started by cron(lM) once a day. 

FILES 

/usr / spool / uucp / SYSLOG 

system log file 
/usr/lib/uucp/L_sub 

connection statistics 
/ usr / lib / uucp / R_sub 

traffic statistics 

SEE ALSO 

uucp(lC), uustat(lC). 
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NAME 

uuto, uupick — public UNDC-to-UNIX file copy 
SYNOPSIS 

uuto [ options ] source-files destination 
uupick [ —s system ] 

DESCRIPTION 

Uuto sends source-files to destination. Uuto uses the tmcp(lC) facility 
to send files, while it allows the local system to control the file access. A 
source-file name is a path name on your machine. Destination has the 
form: 

systemhiser 

where system is taken from a list of system names that uucp knows 
about (see uuname(lC)). Logname is the login name of someone on the 
specified system. 

Two options are available: 

—p Copy the source file into the spool directory before transmission. 

—m Send mail to the sender when the copy is complete. 

The files (or sub-trees if directories are specified) are sent to PUBDIR on 
system, where PUBDIR is a public directory defined in the uucp source. 
Specifically the files are sent to 

PUBDIR/receive/ttser/mysysfem/files. 

The destined recipient is notified by mad(l) of the arrival of files. 

Uupick accepts or rejects the files transmitted to the user. Specifically, 
uupick searches PUBDIR for files destined for the user.' For each entry 
(file or directory) found, the following message is printed on the standard 
output: 

from system: [file file-name] [dir dimame] ? 

Uupick then reads a line from the standard input to determine the dispo¬ 
sition of the file: 


<new-line> 

d 

m [ dir ] 

a [ dir ] 

P 

q 

EOT (control- 


Go on to next entry. 

Delete the entry. 

Move the entry to named directory dir (current directory 
is default). 

Same as m except moving all the files sent from system. 
Print the content of the file. 

Stop. 

d) 


Same as q. 

'command Escape to the shell to do command. 

• Print a command summary. 

Uupick invoked with the —s system option will only search the PUBDIR for 
files sent from system. 
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FILES 


PUBDIR /usr/spool/uucppublic public directory 


SEE ALSO 

mail(l), uuclean(lM), uucp(lC), uulog(lC), uuname(lC), uustat(lC), 
uux(lC). 
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NAME 

uux — unix to unix command execution 
SYNOPSIS 

uux [ — ] command-string 
DESCRIPTION • i 

Uux will gather zero or more files from various systems, execute a com¬ 
mand on a specified system and then send standard output to a file on a 
specified system. Note that, for security reasons, many installations will 
limit the list of commands executable on behalf of an incoming request 
from uux. Many sites will permit little more than the receipt of mail (see 
mail{ l)) via uux. 

The command-string is made up of one or more arguments that look like 
a Shell command line, except that the command and file names may be 
prefixed by system-name !. A null system-name is interpreted as the 
local system. 

File names may be one of 

(1) a full path name; 

(2) a path name preceded by ~xxx where xxx is a login name on 
the specified system and is replaced by that user’s login directory; 

(3) anything else is prefixed by the current directory. 

The — option will cause the standard input to the uux command to be the 
standard input to the command-string. For example, the command 

uux ”!difT usg!/usr/dan/fl pwba!/a4/dan/fl > Ifl.diff" 

will get the fl files from the "usg” and "pwba” machines, execute a diff 
command and put the results in fl.difl in the local directory. 

Any special shell characters such as Oj should be quoted either by quo¬ 
ting the entire command-string, or quoting the special characters as 
individual arguments. 

Uux will attempt to get all files to the execution system. For files which 
are output files, the file name must be escaped using parentheses. For 
example, the command 

uux aluucp b!/usr/file \ (c!/usr/file\) 

will send a uucp command to system “a” to get /usr/file from system “b” 
and send it to system "c”. 

Uux will notify you if the requested command on the remote system was 
disallowed. The response comes by remote mail from the remote 
machine. 

FILES 

/usr/lib/uucp/spool 

spool directory 

/usr/lib/uucp/* other data and programs 
SEE ALSO 

uuclean(lM), uucp(lC). 

Uucp Implementation Description by D. A. Nowitz 
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BUGS 

Only the first command of a shell pipeline may have a system-name !. All 
other commands are executed on the system of the first command. 

The use of the shell metacharacter • will probably not do what you want 
it to do. The shell tokens « and » are not implemented. 
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NAME 

volcopy, labelit — copy file systems with label checking 
SYNOPSIS 

volcopy [—S][—bpibits-per-inch ] [—feetsize ] fsname special 1 volnamel 
special2 volname2 

labelit special [ fsname volume [ —n ] ] 

DESCRIPTION 

Volcopy makes a literal copy of the file system using a blocksize matched 
to the device (10 blocks for 800/1600 bpi tape; 110 blocks for cartridge 
tapes if —S option used; 88 blocks for everything else). Using volcopy, a 
2400 foot/1600 bpi tape will hold a 65K file system. The optional fiag 
arguments are used only with tapes (—bpi — bits-per-inch; —feet — size of 
reel in feet). The program requests the information if it is not given on 
the command line. If the file system is too large to fit on one reel, vol¬ 
copy will prompt for additional reels. Labels of all reels are checked. 
Tapes may be mounted alternately on two drives. 

The fsname argument represents the mounted name (e.g.: root, ul, etc.) 
of the filsystem being copied. 

The special should be the physical disk section or tape (e.g.: /dev/rrpl5, 
/dev/rmtO, /dev/rst0, etc.). 

The volname is the physical volume name , (e.g.: pk3, t0l22, etc.) and 
should match the external label sticker. Such label names are limited to 
five or fewer characters. 

Special 1 and volnamel are the device and volume from which the copy 
of the file system is being extracted. Specin.12 and volname2 are the tar¬ 
get device and volume. 

Fsname and volname are recorded in the last 12 characters of the 
superblock (char fsname[6], volname[6];). 

Labelit can be used to provide initial labels for unmounted disk or tape 
file systems. With the optional arguments omitted, labelit prints current 
label values. The —n option provides for initial labeling of new tapes only 
(this destroys previous contents). 

FILES 

/etc/log/filesave a record of file systems/volumes copied 

SEE ALSO 

filsys(5). 

BUGS 

Only device names beginning /dev/rmt and /dev/rst are treated as 
tapes. 
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NAME 

whatconf — what device drivers are in an Unix kernel 
SYNOPSIS 

/etc/whatconf unixkernel 
DESCRIPTION 

Whatconf tells you what devices the specified unix kernel is configured 
for. 

SEE ALSO 

newconf(lm) 
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NAME 

whodo — who is doing what 

SYNOPSIS 

/etc/whodo 

DESCRIPTION 

Whodo produces merged, reformatted, and dated output from the uiho(l) 
andps(l) commands. 

SEE ALSO 

ps(l), who(l). 
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NAME 

xd — hexadecimal dump 
SYNOPSIS 

xd [ file ] [ ofTsetl[ . ][ b ] [ - [offset2[ . ][ b ] ] 

DESCRIPTION 

Xd dumps file in hexadecimal and as characters. 

The file argument specifies which file is to be dumped. If no file 
argument is specified, the standard input is used. 

The offset argument specifies the offset in the file where dumping is to 
commence. This argument is normally interpreted as hexadecimal bytes. 
If it starts with 'O’, the offset is interpreted in octal. If V is appended, the 
offset is interpreted in decimal. If 'b* is appended, the offset is inter¬ 
preted in blocks of 512 bytes. If the file argument is omitted, the offset 
argument must be preceded *+*. 

If no second offset is specified, dumping continues until end-of-file. Oth¬ 
erwise dumping ends before the specified endaddress. The interpretation 
of offset2 is the same as above. 

SEE ALSO 

adb(l) 
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NAME 


tgetent, tgetnum, tgetflag, tgetstr, tgoto, tputs — terminal independent operation routines 


SYNOPSIS 

char PC; 
char «BC; 
char -UP; 
short ospeed; 

tgetent(bp, name) 
char s bp, •name; 

tgetnnm(id) 
char «id; 

tgetflag (id) 
char «ld; 

g char • 

tgetstrtid, area) 
char *id, ••area; 

char* 

tgoto (cm, destcol, destline) 
char *cm; 

tputs(cp, affcnt, outc) 
register char *cp; 
int affcnt; 

Int («oatc)0; 

DESCRIPTION 

These functions extract and use capabilities from the terminal capability data base termcap(S). 
These are low level routines; see curses(3) for a higher level package. 

Tgetent extracts the entry for terminal name into the buffer at bp. Bp should be a character 
buffer of size 1024 and must be retained through all subsequent calls to tgetnum, tgetflag. and 
tgetstr. Tgetent returns —l if it cannot open the termcap file, 0 if the terminal name given does 
not have an entry, and 1 if all goes well. It will look in the environment for a TERMCAP vari- 
7 i able. If found, and the value does not begin with a slash, and the terminal type name is the 

~ W same as the environment string TERM, the TERMCAP string is used instead of reading the 

termcap file. If it does begin with a slash, the string is used as a path name rather than 
letdtermcap. This can speed up entry into programs that call tgetent, as well as to help debug 
new terminal descriptions or to make one for your terminal if you can’t write the file 
letdtermcap. 



Tgetnum gets the numeric value of capability id. returning — 1 if is not given for the terminal. 
Tgetflag returns 1 if the specified capability is present in the terminal’s entry, 0 if it is not. 
Tgetstr gets the string value of capability id, placing it in the buffer at area, advancing the area 
pointer. It decodes the abbreviations for this field described in termcapiS ), except for cursor 
addressing and padding information. 

Tgoto returns a cursor addressing string decoded from cm to go to column destcol in line destline. 
It uses the external variables UP (from the up capability) and BC (if be is given rather than bs) 
if necessary to avoid placing \n, *D or in the returned string. (Programs which call tgoto 
should be sure to turn off the XTABS bit(s), since tgoto may now output a tab. Note that pro¬ 
grams using termcap should in general turn off XTABS anyway since some terminals use con¬ 
trol I for other functions, such as nondestructive space.) If a % sequence is given which is not 
understood, then tgoto returns “OOPS”. 
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Tputs decodes the leading padding information of the string cp; affcnt gives the number of lines 
affected by the operation, or 1 if this is not applicable, outc is a routine which is called with 
each character in turn. The external variable ospeed should contain the output speed of the ter* 
minal as encoded by say (2). The external variable PC should contain a pad character to be 
used (from the pc capability) if a null (“<§) is inappropriate. 


FILES 


/usr/lib/libtenncap.a —1 term cap library 
/etc/termcap data base 


SEE ALSO 

ex(l), curses(3), termcap(S) 

AUTHOR 

WQliam Joy 

BUGS 
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NAME 

hk — RK611/RK06, RK07 moving-head disk 
DESCRIPTION 

The octal representation of the minor device number is encoded dp, 
where d is a physical drive number, and p is a logical unit (subsection) 
within a physical unit. The origins and sizes of the logical units on each 
drive, counted in cylinders of 66 512-byte blocks, are: 


log. unit 

start cyl. 

length 

size (in blocks) 


0 

0 

146 

9636 

(root on RK06/07) 

1 

146 

135 

8910 

(swap on RK06/07) 

2 

281 

129 

8514 

(rest of RK06) 

3 

281 

533 

35178 

(rest of RK07) 

4 

0 

0 

0 

(spare) 

5 

0 

Q 

0 

(spare) 

6 

0 

410 

27060 

(all of RK06) 

7 

0 

814 

53724 

(all of RK07) 


Systems distributed for these devices use disk 0 for the root, disk 1 for 
swapping, and disk 6 (RK06) or disk 7 (RK07) for a mounted user file sys¬ 
tem. 

The block files access the disk via the system’s normal buffering mechan¬ 
ism and may be read and written without regard to physical disk records. 

A ’raw’ interface provides for direct transmission between the disk and 
the user's read or write buffer. A single read or write call results in 
exactly one I/O operation and therefore raw I/O is considerably more 
efficient when many words are transmitted. The names of the raw files 
conventionally begin with an extra ‘r.’ In raw I/O the buffer must begin 
on a word boundary. 

FILES 

/dev/hk?, /dev/rhk? 

SEE ALSO 

format (8) 

BUGS 

In raw I/O read and write{ 2) truncate file offsets to 512-byte block boun¬ 
daries, and write scribbles on the tail of incomplete blocks. Thus, in pro¬ 
grams that are likely to access raw devices, read, write and lseek{ 2) 
should always deal in 512-byte multiples. 
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NAME 

hp — RP04/05/06, RM02/03 moving-head disk 
DESCRIPTION 

The octal representation of the minor device number is encoded dp, 
where d is a physical drive number, and p is a logical unit (subsection) 
within a physical unit. The origins and sizes of the logical units on each 
drive, counted in cylinders of 418 512-byte blocks, for the RP04/05/06 
are: 


log. unit 

0 

start cyl. 

0 

length 

23 

size (in blocks) 
9614 

(root on RP04/05/06) 

1 

23 

21 

8778 

(swap on RP04/05/06) 

2 

44 

21 

8778 

(/sys on RP04/05/06) 

3 

65 

345 

144210 

(rest of RP04/05) 

4 

65 

749 

313082 

(rest of RP06) 

5 

411 

403 

168454 

(/usr on RP06) 

6 

0 

410 

171380 

(all of RP04/05) 

7 

0 

814 

340252 

(all of RP06) 


The logical units for the RM02/03 are: 


log. unit 

0 

start cyl. 

0 

length 

60 

size (in blocks) 
9600 

(root on RM02/03) 

1 

60 

55 

8800 

(swap on RM02/03) 

2 

115 

50 

8000 

(/sys on RM02/03) 

3 

165 

657 

105120 

(rest of RM02/03) 

4 

0 

0 

0 

(spare) 

5 

0 

0 

' 0 

(spare) 

6 

0 

0 

0 

(spare) 

7 

0 

822 

131520 

(all of RM02/03) 


Systems distributed for these devices use disk 0 for the root, disk 1 for 
swapping, and disk 3 (RP04/05, RM02/03) or disk 4 (RP06) for a mounted 
user file system. _ 

The block files access the disk via the system’s normal buffering mechan¬ 
ism and may be read and written without regard to physical disk records. 

A ’raw’ interface provides for direct transmission between the disk and 
the user’s read or write buffer. A single read or write call results in 
exactly one I/O operation and therefore raw I/O is considerably more 
efficient when many words are transmitted. The names of the raw files 
conventionally begin with an extra *r.’ In raw I/O the buffer must begin 
on a word boundary. 


FILES 

/dev/rp?, /dev/rrp? 
/dev/rm?, /dev/rrm? 

SEE ALSO 

format (8) 


BUGS 

In raw I/O read and write( 2) truncate file offsets to 512-byte block boun¬ 
daries, and write scribbles on the tail of incomplete blocks. Thus, in pro¬ 
grams that are likely to access raw devices, read, write and lseek(2) 
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NAME 

rx — RX01 or RX02 floppy disk 
DESCRIPTION 

The rx driver supports both double sided (DS) or single sided (SS) drives 
and double density (DD) or single density (SD) format. 

Rr? refers to an entire disk as a single sequentially-addressed file. Its 
256-word blocks are numbered 0 to (number of blocks — 1). For the 
number of blocks on a floppy disk see the following table: 

500 SS/SD 

1000 DS/SD 

1001 SS/DD 
2002 DS/DD 

RxO refer to drive 0, single density format, rxl to drive 1, single density 
format, rx2 to drive 0, double density format and rx3 refer to drive 1, 
double density format. 

The rx files discussed above access the disk via the system’s normal 
buffering mechanism and may be read and written without regard to phy¬ 
sical disk records. There is also a ’raw' interface which provides for 
direct transmission between the disk and the user’s read or write buffer. 
A single read or write call results in exactly one 1/0 operation and there¬ 
fore raw I/O is considerably more efficient when many words are 
transmitted. The names of the raw RX files begin with rrx. 

In raw I/O the buffer must begin on a word boundary, and counts should 
be a multiple of 512 bytes (a disk block), 

FILES 

/dev/rx?, /dev/rrx? 

SEE ALSO 

rxctrl (1), format (8) 

BUGS 

In raw I/O read and write(2) truncate file offsets to 512-byte block boun¬ 
daries, and write scribbles on the tail of incomplete blocks. Thus, in pro¬ 
grams that are likely to access raw devices, read, write and lseek( 2) 
should always deal in 512-byte multiples. 
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NAME 

st — SCTll Streamer interface 
DESCRIPTION 

The special files rstO, nrstO refer to the streamer drive 0. The letter r 
indicates "raw" device, the letter n indicates "no rewind" when the 
streamer is closed. For nrstO the bit 0200 in the minor device number 
must be set. To rewind the streamer tape you can say " < /dev/rstO ". 

The raw devices rstO and nrstO allow transfers of up to 127 512-byte 
blocks with a single read or write call. The byte count should always be 
an exact multiple of 512. 

Unfortunately, when copying blocks from disk to tape, the streamer 
needs data faster than MUNIX can provide. Therefore, the streamer over- 
or underruns its internal buffers and does not stream. This means that 
after it has transferred some data, the tape will stop. When subsequent 
data arrives, it will rewind a piece of tape, then read forward to where it 
stopped, and immediately write the data. This zigzag-motion of the tape 
can be very time-consuming. The "zig" occurs when transferring data, 
and its time is proportional to the amount of data transferred. The "zag" 
is the rewind, and its time is constant. The ratio of ”zig"-time to "zag"- 
time becomes tolerable, when the amount of data transferred with one 
"zig” gets large. 

Two programs have been modified to use larger buffersizes when working 
with the streamer: cpio and volcopy. For both programs, the option —S 
sets the blocking factor to high values (120 for cpio, 110 for volcopy). 
The program volcopy now also exists in a standalone version. These pro¬ 
grams allow you to backup your disks properly. Once in a while you 
should make a physical copy of your root file system with volcopy. The 
standalone version of volcopy can then be used to recreate a root file 
system after a catastrophic failure. At least once a day you should make 
a total or incremental dump of all files with cpio. From the cpio-tapes you 
can easily retrieve single files or whole directories. 

EXAMPLES 

total dump: 

find / -print | cpio -oS >/dev/rst0 
incremental dump (last three days, say) 

find / -mtime -3 -print | cpio -oS >/dev/rst0 
file retrieval: 

cpio -ivS myfile </dev/rst0 
physical dump: 

labelit /dev/rstO root tapel -n 
volcopy -S root /dev/rhkO hkO /dev/rstO tapel 
standalone (only terminal input shown): 

/sa/volcopy 

go 

-S root st(0,0) tapel hk(0,0) root 

SEE ALSO 

volcopy(l), cpio(l), labelit(l), stctrl(l) 

BUGS 
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1 ) 

2 ) 



3) 

4) 


While rewinding to Begin Of Tape (BOT) the system pauses. 

Using nrstO in subsequent calls from command scripts can cause 
trouble. A sleep 2 after each streamer operation will help. For 
example: (making a cartridge with standalone programs) 

< /dev/rstO 

cat /sa/boot >/dev/nrstO 
sleep 2 

cat /sa/volcopy >/dev/nrstO 
sleep 2 

cat /sa/emuformat >/dev/rstO 

The same is true for programmed I/O. After a close your program 
should sleep about 2 seconds before opening the streamer again. 

Do not care too much for the message streamer error: cannot read 
status. In most cases the last streamer operation was completed 
sucessfully. 



(for your remarks) 
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NAME 

fsub — static information about the filesystems 

SYNOPSIS 

#inelode <fstab.h> 


DESCRIPTION 

The file ktdfetab contains descriptive information about the various file systems, ktdfetab is 
only read by programs, and not written; it is the duty of the system administrator to properly 
create and maintain this file. 


These programs use ktdfetab: dump, mount, umount, swapon, feck and df. The order of records in 
ktdfetab is important, for both feck, mount, and umount sequentially iterate through ktdfetab 
doing their thing. 




The special file name is the block special file* name, and not the character special file name. If a 
program needs the character special file name, the program must create it by appending a “r ’ 
after the last in the special file name. 


If fejype is “rw” or “ro” then the file system whose name is given in the fa_file field is nor¬ 
mally mounted read-write or read-only on the specified special file. The fijfreq field is used for 
these file systems by the dumpd) command to determine which file systems need to be 
dumped. The fajassno field is used by the fackil) program to determine the order in which 
file system checks are done at reboot time. The root file system should be specified with a 
fa jassn o of 1, and other file systems should have larger numbers. File systems within a drive 
should have distinct numbers, but file systems on different drives can be checked on the same 
P mss to utilize parallelism available in the hardware. 

If fejype is “sw” then the special file is made avaiable as a piece of swap space by the 
swapond) command at the end of the system reboot procedure. The fields other than fejpec 


sod fejype ** not used in this case. 


Fsjype may be specified as **xx" to cause an entry to be ignored.'This is useful to show disk 
partitions which are currently not used but will be used later. * 


#define FSTAB 
#define FSNMLG 


Vetc/fsub* 

16 


#define FSTABFMT *% 16s.-% 16sr%2s:%d:%d\n’ 

#define FSTABARG(p) (p)—>fs_spec, (p)->fs_file, \ 

(p) - >fs type, &(p) - >fs_freq, <k(p)- >fsj»ssno 

#define FSTABNARGS 5 


#define FSTAB_RW •rw* 

#define FSTAB”RO *ro’ 

#define FSTAB’SW *sw' 

#define FSTAB XX *xx’ 


/• read write device •/ 
/• read only device •/ 
/• swap device •! 

/• ignore totally •/ 


struct fsub ( 

char fs_spec(FSNMLG]; /• block special device name 


); 


char fs_file IFSNMLG1; 
char fs_typel3]; 
int fsjreq; 
int fsjussno; 


/• file system path prefix •/ 

/• rw,ro,sw or xx •/ 

/• dump frequency, in days •/ 

/• pass number on parallel dump •/ 
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* 


e proper way to read records from /etc/fstab is to use the routines getfsentO, getfsspecO or 
getfsfileO. 


ILES 

/etc/fstab 

EE ALSO 

getfsentO) 
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NAME 

term cap — terminal capability data base 

SYNOPSIS 

/etc/termcap 

DESCRIPTION 

Termcap is a data base describing terminals, used, e.g., by W( 1) and cursestt). Terminals are 
described in termcap by giving a set of capabilities which they have, and by describing how 
operations are performed. Padding requirements and initialization sequences are included in 
termcap. 

Entries in termcap consist of a number of separated fields. The first entry for each terminal 
gives the names which are known for the terminal, separated by f characters. The first name is 
always 2 characters long and is used by older version 6 systems which store the terminal type in 
a 16 bit word in a systemwide data base. The second name given is the most common abbrevi¬ 
ation for the terminal, and the last name given should be a long name fully identifying the ter¬ 
minal. The second name should contain no blanks; the last name may well contain blanks for 
readability. 

CAPABILITIES 

(P) indicates padding may be specified 
(?•) indicates that padding may be based on no. lines affected 


Name 

Type 

Pad? 

Description 

ae 

sir 

(P) 

End alternate character set 

ai 

sir 

(P-) 

Add new blank, line 

am 

bool 


Terminal has automatic margins 

as 

sir 

(P) 

Start alternate character set 

be 

sir 


Backspace if not 'H 

bs 

bool 


Terminal can backspace with *H 

bt 

sir 

(P) 

Back tab 

bw 

bool 


Backspace wraps from column 0 to last column 

CC 

sir 


Command character in prototype if terminal settable 

cd 

sir 

(P-) 

Gear to end of display 

ce 

sir 

(P) 

Gear to end of line 

ch 

sir 

(P) 

Like cm but horizontal motion only, line stays same 

d 

sir 

(P-) 

Gear screen 

cm 

str 

(P) 

Cursor motion 

CO 

num 


Number of columns in a line 

cr 

sir 

(P-) 

Carriage return, (default *M) 

cs 

sir 

(P) 

Change scrolling region (vtlOO), like cm 

cv 

str 

(P) 

Like ch but vertical only. 

da 

bool 


Display may be retained above 

dB 

num 


Number of millisec of bs delay needed 

db 

bool 


Display may be retained below 

dC 

num 


Number of millisec of cr delay needed 

dc 

sir 

(P-) 

Delete character 

dF 

num 


Number of millisec of ff delay needed 

dl 

sir 

(P«) 

Delete line 

dm 

str 


Delete mode (enter) 

dN 

num 


Number of millisec of nl delay needed 

do 

sir 


Down one line 

dT 

num 


Number of millisec of tab delay needed 

ed 

sir 


End delete mode 
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es 

str 


End insert mode; give “:ei™:” if Ic 

eo 

str 


Can erase overstrikes with a blank 

ff 

str 

(p-) 

Hardcopy terminal page eject (default *L) 

he 

bool 


Hardcopy terminal 

hd 

str 


Half-line down (forward 1/2 linefeed) 

ho 

str 


Home cursor (if no cm) 

bu 

str 


Half-line up (reverse 1/2 linefeed) 

h z 

str 


Hazeltine; can’t print ”’s 

k 

str 

o») 

Insert character 

if 

str 


Name of file containing is 

im 

bool 


Insert mode (enter); give “am*:” if ic 

in 

bool 


Insert mode distinguishes nulls on display 

ip 

str 

(p-> 

Insert pad after character inserted 

is 

str 


Terminal initialization string 

k0-k9 str 


Sent by “other” function keys 0-9 

kb 

str 


Sent by backspace key 

kd 

str 


Sent by terminal down arrow key 

ke 

str 


Out of “keypad transmit” mode 

kh 

str 


Sent by home key 

kl 

str 


Sent by terminal left arrow key 

kn 

num 


Number of “other” keys 

ko 

str 


Termcap entries for other non-function keys 

kr 

str 


Sent by terminal right arrow key. 

ks 

str 


Put terminal in “keypad transmit” mode 

ku 

str 


Sent by terminal up arrow key 

10-19 

sir 


Labels on “other” function keys 

li 

num 


Number of lines on screen or page 

a 

str 


Last line, first column (if no cm) 

ma 

str 


Arrow key map, used by vi version 2 only 

mi 

bool 


Safe to move while in insert mode 

ml 

str 


Memory lock on above cursor. 

mu 

str 


Memory unlock (turn off memory lock). 

nc 

bool 


No correctly working carriage return (DM2500,H2000) 

nd. 

str 


Non-destructive space (cursor right) 

ni 

str 

(p«> 

Newline character (default \n) 

ns 

bool 


Terminal is a CRT but doesn’t scroiL 

os 

bool 


Terminal overstrikes 

pc 

str 


Pad character (rather than null) 

pt 

bool 


Has hardware tabs (may need to be set with Is) 

se 

str 


End stand out mode 

sf 

str 

(p> 

Scroll forwards 

sg 

num 


Number of blank chars left by so or se 

so 

str 


Begin stand out mode 

sr 

str 

<p) 

Scroll reverse (backwards) 

ta 

str 

(p) 

Tab (other than *1 or with padding) 

tc 

str 


Entry of similar terminal • must be last 

te 

str 


String to end programs that use cm 

ti 

str 


String to begin programs that use cm 

uc 

str 


Underscore one char and move past it 

ue 

str 


End underscore mode 

ug 

num 


Number of blank chars left by us or ue 

ui 

boot 


Terminal underlines even though it doesn’t overstrike 
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up 

str 

Upline (cursor up) 

US 

str 

Start underscore mode 

vb 

str 

Visible bell (may not move cursor) 

ve 

str 

Sequence to end open/visual mode 

vs 

str 

Sequence to start open/visual mode 

xb 

bool 

Beehive (fl—escape, f2—ctrl C) 

xn 

bool 

A newline is ignored after a wrap. (Concept) 

XT 

bool 

Return acts like ce \r \n (Delta Data) 

xs 

bool 

Standout not erased by writing over it (HP 264?) 

xt 

bool 

Tabs are destructive, magic so char (Teleray 1061) 

A Sample Entry 



The following entry, which describes the Concept—100, is among the more complex entries in 
the termcap file as of this writing. (This particular concept entry is outdated, and is used as an 
example only.) 

cl|cl00|conceptl00:is-\EU\Ef\E7\E5\ES\EAENH\EK\E\200\Eo£\200:\ 

:al-3'\E'R:am:bs:cd-16-\E*C:ce-16\E‘S:d-2-*L:cm-\Ea%+ %+ :co#80:\ 
:dc» 16 \E*A:dl—3«\E*B:ei«\E\200:eo:im“\E*P:in:ip—16»:li#24:mi:nd—\E—:\ 
ae -\Ed\Ee:so -\ED\EE:ta- 8\t:ul:up -\E;:vb—\Ek\EK:xn: 

Entries may. continue onto multiple lines by giving a \ as the last character of a line, and that 
empty fields may be included for readability (here between the last field on a line and the first 
field on the next). Capabilities in termcap are of three types: Boolean capabilities which indicate 
that the terminal has some particular feature, numeric capabilities giving the size of the termi¬ 
nal or the size of particular delays, and string capabilities, which give a sequence which can be 
used to perform particular terminal operations. 

Types of Capabilities 

All capabilities have two tetter codes. For instance, the fact that the Concept has “automatic 
margins’* (i.e. an automatic return and linefeed when the end of a line is reached) is indicated 
by the capability am. Hence the description of the Concept includes am. Numeric capabilities 
are followed by the character *#’ and then the value. Thus co which indicates the number of 
columns the terminal has gives the value ’80* for the Concept. 

Finally, string valued capabilities, such as ce (clear to end of line sequence) are given by the 
two character code, an *■■*, and then a string ending at the next following *:*. A delay in mil¬ 
liseconds may appear after the in such a capability, and padding characters are supplied by 

the editor after the remainder of the string is sent to provide this delay. The delay can be 
either a integer, e.g. ‘20*, or an integer followed by an *•*, i.e. *3«*. A *•’ indicates that the 
padding required is proportional to the number of lines affected by the operation, and the 
amount given is the per-affected-unit padding required. When a *•’ is specified, it is sometimes 
useful to give a delay of the form ‘3.5’ specify a delay per unit to tenths of milliseconds. 

A number of escape sequences are provided in the string valued capabilities for easy encoding 
of characters there. A \E maps to an ESCAPE character. *x maps to a control-x for any 
appropriate x, and the sequences \n \r \f \b \f give a newline, return, tab, backspace and 
formfeed. Finally, characters may be given as three octal digits after a \, and the characters * 
and \ may be given as \* and \\. If it is necessary to place a : in a capability it must be escaped 
in octal as \072. If it is necessary to place a null character in a string capability it must be 
encoded as \200. The routines which deal with termcap use C strings, and strip the high bits of 
the output very late so that a \200 comes out as a \000 would. 
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Preparing Descriptions 

We now outline how to prepare descriptions of terminals. The most effective way to prepare a 
terminal description is by imitating the description of a similar terminal in termcap and to build 
up a description gradually, using partial descriptions with ex to check that they are correct. Be 
aware that a very unusual terminal may expose deficiencies in the ability of the termcap file to 
describe it or bugs in ex. To easily test a new terminal description you can set the environment 
variable TERMCAP to a pathname of a file containing the description you are working on and 
the editor will look there rather than in letdtermcap. TERMCAP can also be set to the termcap 
entry itself to avoid reading the file when starting up the editor. (This only works on version 7 
systems.) 

Basic capabilities 

The number of columns on each line for the terminal is given by the co numeric capability. If 
the terminal is a CRT, then the number of lines on the screen is given by the 11 capability. If 
the terminal wraps around to the beginning of the next line when it reaches the right margin, 
then it should have the am capability. If the terminal can dear its screen, then this is given by 
the d string capability. If the terminal can backspace, then it should have the bs capability, 
unless a backspace is accomplished by a character other than *H (ugh) in which case you 
should give this character as the be string capability. If it overstrikes (rather than dearing a 
position when a character is struck over) then it should have the os capability. 

A very important point here is that the local cursor motions encoded in termcap are undefined 
at the left and top edges of a CRT terminal. The editor will never attempt to backspace around 
the left edge, nor will it attempt to go up locally off the top. The editor assumes that feeding 
off the bottom of the screen will cause the screen to scroll up, and the am capability tells 
whether the cursor sticks at the right edge of the screen. If the terminal has switch selectable 
automatic margins, the termcap file usually assumes that this is on, i.e. am. 

These capabilities suffice to describe hardcopy and “glass-tty” terminals, thus the model 33 
teletype is described as 

t31331 tty33:co#72:os 

while the Lear Siegler aDM- 3 is described as 

d|adm3t3|lsi adm3:am:bs:d—*Z:li#24:co#80 
Cursor addressing 

Cursor addressing in the terminal is described by a cm string capability, with printf{2s) like 
escapes %x in it. These substitute to encodings of the current line or column position, while 
other characters are passed through unchanged. If the cm string is thought of as being a func¬ 
tion, then its arguments are the line and then the column to which motion is desired, and the 
% encodings have the following meanings: 

%d as in pnntf, 0 origin 
%2 like %2d 

%3 like %3d 

%. like %c 

%+x adds xto value, then %. 

%>xy if value > x adds y, no output. 

%r reverses order of line and column, no output 
%i increments line/coiumn (for l origin) 

%% gives a single % 

%n exclusive or row and column with 0140 (DM2500) 

%B BCD (16*(x/10)) + (x%10), no output. 

%D Reverse coding (x-2«(x%!6)), no output. (Delta Data). 


.. ^ 

( " 


/ 


\ 
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Consider the HP2645, which, to get to row 3 and column 12, needs to be sent \E<fcal2c03Y 
padded for 6 milliseconds. Note that the order of the rows and columns is inverted here, and 
that the row and column are printed as two digits. Thus its cm capability is 
“cm-6\Ei%r%2c%2Y”. The Microterm ACT-lv needs the current row and column sent pre¬ 
ceded by a “T. with the row and column simply encoded in binary, “cm™*T%.%.“. Terminals 
which use need to be able to backspace the cursor (bs or be), and to move the cursor up 
one line on the screen (up introduced below). This is necessary because it is not always safe to 
transmit \t, \n "D and \r, as the system may change or discard them. 

A final example is the LSI ADM-3a, which uses row and column offset by a blank character, thus 
“cm-\E-%+ %+ 

Cursor motions 

If the terminal can move the cursor one position to the right, leaving the character at the 
current position unchanged, then this sequence should be given as nd (non-destructive space). 
If it can move the cursor up a line on the screen in the same column, this should be given as 
up. If the terminal has no cursor addressing capability, but can home the cursor (to very upper 
left comer of screen) then this can be given as ho; similarly a fast way of getting to the lower 
left hand comer can be given as II; this may involve going up with up from the home position, 
but the editor will never do this itself (unless 11 does) because it makes no assumption about 
the effect of moving up from the home position. 

Area clean 

If the terminal can dear from the current position to the end of the line, leaving the cursor 
where it is. this should be given as ce. If the terminal can dear from the current position to 
the end of the display, then this should be given as cd. The editor only uses cd from the first 
column of a line. 

Insert/delete line 

If the terminal can open a new blank line before the line where the cursor is, this should be 
given as a!; this is done only from the first position of a line. The cursor must then appear on 
the newly blank line. If the terminal can-delete the line which the cursor is on, then this 
should be given as dl; this is done only from the first position on the line to be deleted. If the 
terminal can scroll the screen backwards, then this can be given as sb. but just al suffices. If 
the terminal can retain display memory above then the da capability should be given; if display 
memory can be retained below then db should be given. These let the editor understand that 
deleting a line on the screen may bring non-blank lines up from below or that scrolling back 
with sb may bring down non-blank lines. 

Insert/delete character 

There are two basic kinds of intelligent terminals with respect to insert/delete character which 
can be described using termcap. The most common insert/delete character operations affect only 
the characters on the current line and shift characters off* the end of the line rigidly. Other ter¬ 
minals, such as the Concept 100 and the Perkin Elmer Owl, make a distinction between typed 
and untyped blanks on the screen, shifting upon an insert or delete only to an untyped blank on 
the screen which is either eliminated, or expanded to two untyped blanks. You can find out 
which kind of terminal you have by clearing the screen and then typing text separated by cursor 
motions. Type “abc def” using local cursor motions (not spaces) between the “abc” and the 
“def\ Then position the cursor before the “abc” and put the terminal in insert mode. If typ¬ 
ing characters causes the rest of the line to shift rigidly and characters to fall off* the end. then 
your terminal does not distinguish between blanks and untyped positions. If the “abc” shifts 
over to the “def* which then move together around the end of the current line and onto the 
next as you insert, you have the second type of terminal, and should give the capability in, 
which stands for “insert null”. If your terminal does something different and unusual then you 
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may have to modify the editor to get it to use the insert mode your terminal defines. We have 
seen no terminals which have an insert mode not not falling into one of these two classes. 

The editor can handle both terminals which have an insert mode, and terminals which send a 
simple sequence to open a blank position on the current line. Give as im the sequence to get 
into insert mode, or give it an empty value if your terminal uses a sequence to insert a blank 
position. Give as ei the sequence to leave insert mode (give this, with an empty value also if 
you gave Im so). Now give as Ic any sequence needed to be sent just before sending the char* 
acter to be inserted. Most terminals with a true insert mode will not give ic terminals which 
SCT d a sequence to open a screen position should give it here. (Insert mode is preferable to the 
seq ue nc e to open a position on the screen if your terminal has both.) If post insert padding is 
needed, give this as a number of milliseconds in Ip (a string option). Any other sequence 
which may need to be sent after an insert of a single character may also be given in ip. 

It is occasionally necessary to move around while in insert mode to delete characters on the 
same line (eg. if there is a tab after the insertion position). If your terminal allows motion 
while in insert mode you can give the capability mi to speed up inserting in this case. Omitting 
mi will affect only speed. Some terminals (notably Datamcdia s) must not have mi because of 
the way their insert mode works. 

Finally, you can specify delete mode by giving dm and ed to enter and exit delete mode, and dc 
to delete a single character while in delete mode. 

Highlighting, underlining, and visible bells 

If your terminal has sequences to enter and exit standout mode these can be given as so and se 
respectively. If there are several flavors of standout mode (such as inverse video, blinking, or 
underlining - half bright is not usually an acceptable “standout” mode unless the terminal is 
in inverse video mode constantly) the preferred mode is inverse video by itself. If the code to 
change into or out of standout mode leaves one or even two blank spaces on the screen, as the 
TVI 912 and Teleray 1061 do, this is acceptable, and although it may confuse some programs 
slightly, it can’t be helped. 

Codes to begin underlining and end underlining can be given as us and ue respectively. If the 
terminal has a code to underline the current character and move the cursor one space to the 
right, such as the Microterm Mime, this can be given as uc. (If the underline code does not 
move the cursor to the right, give the code followed by a nondestructive space.) 

If the terminal has a way of flashing the screen to indicate an error quietly (a bell replacement) 
then this can be given as vb; it must not move the cursor. If the terminal should be placed in a 
different mode during open and visual modes of ex this can be given as vs and ve. sent at the 
start and end of these modes respectively. These can be used to change, e.g.. from a underline 
to a block cursor and back. 

If the terminal needs to be in a special mode when running a program that addresses the cur¬ 
sor, the codes to enter and exit this mode can be given as ti and te. This arises, for example, 
from terminals like the Concept with more than one page of memory. If the terminal has only 
memory relative cursor addressing and not screen relative cursor addressing, a one screen-sized 
window must be fixed into the terminal for cursor addressing to work properly. 

If your terminal correctly generates underlined characters (with no special codes needed) even 
though it does not overstrike, then you should give the capability uL If overstrikes are erasable 
with a blank, then this should be indicated by giving eo. 




Keypad 


If the terminal has a keypad that transmits codes when the keys are pressed, this information 
can be given. Note that it is not possible to handle terminals where the keypad only works in 
local (this applies, for example, to the unshifted HP 2621 keys). If the keypad can be set to 
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transmit or not transmit, give these codes as ks and ke. Otherwise the keypad is assumed to 
always transmit. The codes sent by the left arrow, right arrow, up arrow, down arrow, and 
home keys can be given as ki, kr, ku, kd. and kh respectively. If there are function keys such 

as fO. fl.f9, the codes they send can be given as kO, kl, .... k9. If these keys have labels 

other than the default fO through f9. the labels can be given as 10,11,.... 19. If there are other 
keys that transmit the same code as the terminal expects for the corresponding function, such 
as clear screen, the termcap 2 letter codes can be-given in the ko capability, for example. 
“:ko-d,ll,sf,sb:*\ which says that the terminal has clear, home down, scroll down, and scroll 
up keys that transmit the same thing as the cL, 11, sf, and sb entries. 

The ma entry is also used to indicate arrow keys on terminals which have single character arrow 
keys. It is obsolete but still in use in version 2 of vi, which must be run on some minicomput¬ 
ers due to memory limitations. This field is redundant with kl, kr, ku, kd, and kh. It consists 
of groups of two characters. In each group, the first character is what an arrow key sends, the 
second character is the corresponding vi command. These commands are h for kl, j for kd. k 
for ku, I for kr, and H for kh. For example, the mime would be :ma«*Kj*Zk*Xl: indicating 
arrow keys left (*H), down (*K), up (*Z), and right CX). (There is no home key on the 
mime.) 

Miscellaneous 

If the terminal requires other than a null (zero) character as a pad, then this can be given as pc 

If tabs on the terminal require padding, or if the terminal uses a character other than *1 to tab. 
then this can be given as ta. 

Hazeltine terminals, which don’t allow characters to be printed should indicate hz. 
Datamedia terminals, which echo carriage-return linefeed for carriage return and then ignore a 
following linefeed should indicate nc Early Concept terminals, which ignore a linefeed 
immediately after an am wrap, should indicate xn. If an erase-eol is required to get rid of stan¬ 
dout (instead of merely writing on top of it), xs should be given. Teleray terminals, where tabs 
turn all characters moved over to blanks, should indicate xt. Other specific terminal problems 
may be corrected by adding more capabilities of the form xx 

Other capabilities include is, an initialization string for the terminal, and if, the name of a file 
containing long initialization strings. These strings are expected to properly clear and then set 
the tabs on the terminal, if the terminal has settable tabs. If both are given, is will be printed 
before if. This is useful where if is / usr/lib/tabset/sid but is dears the tabs first. 

Similar Terminals 

If there are two very similar terminals, one can be defined as being just like the other with cer¬ 
tain exceptions. The string capability tc can be given with the name of the similar terminal. 
This capability must be last and the combined length of the two entries must not exceed 1024. 
Since termlib routines search the entry from left to right, and since the tc capability is replaced 
by the corresponding entry, the capabilities given at the left override the ones in the similar ter¬ 
minal. A capability can be cancelled with xx@ where xx is the capability. For example, the 
entry 

hn12621 nl:ks@ :ke<§ :tc «•2621: 

defines a 2621ni that does not have the ks or ke capabilities, and hence does not turn on the 
function key labels when in visual mode. This is useful for different modes for a terminal, or 
for different user preferences. 


FILES 

/etc/termcap file containing terminal descriptions 
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SEE ALSO 

ex(1). curses(3), termcap(3), tset(l), vi(l), ul(l), moreU) 

AUTHOR 

William Joy 

Mark Horton added underlining and keypad support 

. BUGS *' 

Ex allows only 256 characters for string capabilities, and the routines in termcap(3) do not check 
for overflow of this buffer. The total length of a single entry (excluding only escaped newlines) 
may not exceed 1024. 

The me, vs, and re entries are specific to the W program. 

Not all programs support all entries. There are entries that are not supported by any program. 
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NAME 

ttytype — data base of terminal types by port 


SYNOPSIS 

/etc/ttytype ' 

DESCRIPTION 

Ttytype is a database containing, for each tty port on the system, the kind of terminal that 
attached to it. There is one line per port, containing the terminal kind (as a name listed 
. termcap (5)), a space, and the name of the ay, minus /dev/. 

This information is read by tser(I) and by login (1) to initialize the TERM variable at login time. 

SEE ALSO 

tset(l), login(l) 


BUGS 



Some lines are merely known as “dialup** or “plugboard**. 


) 


) 



) 
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NAME 

startrek - THE game based on the t.v. series. 

SYNOPSIS 

/usr/games/startrek 

DESCRIPTION 

You are the captain of the starship Enterprise and you have to destroy a 
random number of klingons (typically 15-25) in 30 stardates. (A measure 
of time in space, think of it as a day.) Full instructions are given if you 
reply y to DO YOU WANT INSTRUCTIONS? A brief list of instructions is 
given if you ever type in an illegal command. 

If you reply ’p’ to PILOT TRAINING OR REAL MISSION? the computer asks 
you for a task number. This is used to start the random number genera¬ 
tor so you can play in the same galaxy again if you want to. 

Docking at a starbase refuels and rearms the Enterprise. If you stop for 
repairs you are delayed one stardate. Waiting for repairs in space might 
. also cost you time. 

BUGS 

The calculator returns distances slightly too large for inter-quadrant 
travel. 

FILES 

/usr/games/startrek object code 
/usr/lib/startrek instructions 

AUTHOR 

Originally written in Basic by Mike Mayfield, Centreline Engineering and 
extended by David Ahl of Creative Computing. 

Translated into C and extended by M.J.Bayliss UKC April-October 1977. 
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NAME 

configuration information — table of interrupt vector and device 
addresses 

SYNOPSIS 

cat /usr/sys/conftnfo 
DESCRIPTION 

Confinfo is a table of the interrupt vector and device addresses used in 
MUNIX. It contains: (see next page) 
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NAME 

format — how to format disks 

SYNOPSIS 

/bin/nxctrl —f 

/sa/rxformat 

/sa/rlformat 

/sa/rmformat 

/sa/emuformat 

/sa/xyloformat 

DESCRIPTION 

Rxctrl formats a 5 1/4” floppy emulating a single sided, double density 
8” floppy with a ANDROMEDA WDCll controller. For further details see 
KXCTRL(l) the floppy driver manipulation program. 

All the other formatting programs are standalone programs. Enter the 
Minitor (Type sync, push INIT) and type i.e.: 

.rl (load from RL02) 

./sa/emuformat (executable file) 

.gO (start the program) 

Rxformat formats a 8” floppy RX02 compatible. The floppy controller 
responses ‘S'. Type... 

XD2 (double density) or 
XDl (single density) <cr> 
and 

XUO (left drive) or 
XUl (right drive) <cr> 

Rlformat formats a whole TANDON TM603SE drive with a ANDROMEDA 
WDCll controller as a RL02. The following arguments are interactively 
asked for: * 

UNIT: 0 (TANDON drive 0) 

1 (TANDON drive 1) 

INTERLEAVE: 1..31 (odd) 

Use 5 to optimize the seek time. 

Rmformat formats one or all tracks of a FUJITSU M2312K drive with a 
DATARAM S04/A controller as a RM02. The following arguments are 
interactively asked for: 

SINGLE TRACK ? 'y' or <cr> if yes... 

HEAD: 0..4 

TRACK: 0..822 

Emuformat formats a whole FUJITSU M2312K drive with a EMULEX SC02 
controller as 

Unit 0: RK07 Unit 3: RK07 
Unit 1: RK07 Unit 4: RK07 
Unit 2: RK06 Unit 5: RK06 
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NAME 

fsck — file system consistency check and interactive repair 


SYNOPSIS 

/etc/fsck -p [ filesystem ... 1 

/etc/fsck [ -y ] [ — n 1 l -sX ] I -SX ] l —t filename ] [ filesystem ] 


DESCRIPTION 

The first form of fsck preens a standard set of filesystems or the specified file systems. It is 
normally used in the script /etc/re during automatic reboot. In this case fsck reads the table 
/etc/fstab to determine which file systems to check. It uses the information there to inspect 
groups of disks in parallel taking maximum advantage of i/o overlap to check the file systems as 
quickly as possible. Normally, the root file system will be checked on pass 1, other "root” 
(“a” partition) file systems on pass 2, other small file systems on separate passes (e.g. the “d” 
file systems on pass 3 and the “e” file systems on pass 4), and finally the large user file systems 
on the last pass, e.g. pass 5. A pass number of 0 in fstab causes a disk to not be checked; simi¬ 
larly partitions which are not shown as to be mounted “rw” or “ro” are not checked. 



The system takes care that only a restricted class of innocuous inconsistencies can happen 
unless hardware or software failures intervene. These are limited to the following; 

Unreferenced inodes 


Link counts in inodes too large 




Missing blocks in the free list 
Blocks in the free list also in files 
Counts in the super-block wrong 

These are the only inconsistencies which fsck with the -p option will correct; if it encounters 
other inconsistencies, it exits with an abnormal return status and an automatic reboot will then 
fail. For each corrected inconsistency one or more lines will be printed identifying the file sys¬ 
tem on which the correction will take place, and the nature of the correction. After success¬ 
fully correcting a file system, fsck will print the number of files on that file system and the 
number of used and free blocks. 

Without the -p option, fsck audits and interactively repairs inconsistent conditions for file sys¬ 
tems. If the file system is inconsistent the operator is prompted for concurrence before each 
correction is attempted. It should be noted that a number of the corrective actions which are 
not fixable under the — p option will result in some loss of data. The amount and severity of 
data lost may be determined from the diagnostic output The default action for each con¬ 
sistency correction is to wait for the operator to respond yes or no. If the operator does not 
have write permission jfefcwill default to a — n action. 

Fsck has more consistency checks than its predecessors check, dcheck, /check, and check com¬ 
bined. 


The following flags are interpreted by fsck. 

—y Assume a yes response to all questions asked by fsck: this should be used with great cau¬ 
tion as this is a free license to continue after essentially unlimited trouble has been 
encountered. 

—n Assume a no response to all questions asked by fsck; do not open the file system for 
writing. 

-sX Ignore the actual free list and (unconditionally) reconstruct a new one by rewriting the 
super-block of the file system. The file system should be unmounted while this is done; 
if this is not possible, care should be taken that the system is quiescent and that it is 
rebooted immediately afterwards. This precaution is necessary so that the old, bad. in- 
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core copy of the superblock will not conu'nue to be used, or written on the file system. 


The ~$X option allows for creating an optimal free-list organization. The following 
forms of Xnc supported for the following devices: 


—s3 (RP03) 

-s4 (RP04, RP05, RP06) 

—sBIocks-per-cylinder:Blocks-to-skip (for anything else) 

If X is not given, the values used when the filesystem was created are used. If these 
values were not specified, then the value 400:9 is used. 

-SX Conditionally reconstruct the free list This option is like —sJfabove except that the free 
list is rebuilt only if there were no discrepancies discovered in the file system. Using —S 
wiQ force a no response to all questions asked by fide. This option is useful for forcing 
free list reorganization on uncontaminated file systems. 



—t If fide cannot obtain enough memory^to keep its tables, it uses a scratch file. If the —t 

option is specified, the file named in the next argument is used as the scratch file, if 
needed. Without the -t flag, fsck will prompt the operator for the name of the scratch 
file. The file chosen should not be on the filesystem being checked, and if it is not a spe¬ 
cial file or did not already exist, it is removed when fade completes. 

If no filesystems are given to fsck then a default list of file systems is read from the file 
/etc/fstah. 

Inconsistencies checked are as follows: 


1 . 

1 

3. 

4. 

5. 

6 . 
7. 



Blocks claimed by more than one inode or the free list. 

Blocks claimed by an inode or the free list outside the range of the file system. 
Inconect link counts. 

Size checks: 

Directory size not 16-byte aligned. 

Bad inode format. 

Blocks not accounted for anywhere. 

Directory checks: 

File pointing to unallocated inode. 

Inode number out of range. 

Super Block checks: 

More than 65536 inodes. 

More blocks for inodes than there are in the file system. 

Bad free block list format. 

Total free block and/or free inode count incorrect. 


Orphaned files and directories (allocated but unreferenced) are, with the operator’s con¬ 
currence, reconnected by placing them in the lost 4* found directory. The name assigned is the 
inode number. The only restriction is that the directory lost+found must preexist in the root of 
the filesystem being checked and must have empty slots in which entries can be made. This is 
accomplished by making lost* found, copying a number of files to the directory, and then 
removing them (before fade vs executed). 


Checking the raw device is almost always faster. 


FILES 

/etc/fstab contains default list of file systems to check. 


DIAGNOSTICS 


The diagnostics produced by fade sit intended to be self-explanatory. 
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NAME 

getty — set typewriter mode 
SYNOPSIS 

/etc/getty [ char ] 

DESCRIPTION 

Getty is invoked by init{ 8) immediately after a typewriter is opened fol¬ 
lowing a dial-up. It reads the user’s login name and calls £opin(l) with 
the name as argument. While reading the name getty attempts to adapt 
the system to the speed and type of terminal being used. 

Init calls getty with a single character argument taken from the ttys( 5) 
file entry for the terminal line, which is now ignored. Getty looks for the 
terminal line name with the ttyname call and then searches through the 
ttytype data base. This data base has 6 entries for each terminal line of 
the following form. 

TERM device in speed out speed login mode shell mode 

pt80 ttyO 300 300 PA;RW;CR1 PA;EC;TX;CR1 

pv tty10 9600 9600 PA;RW PA;EC 

The first entry is the TERM variable for the terminal type (see also 
termcap (5)) , the second entry is the device name of the terminal line 
without ’/dev/', the third and fourth entries are the terminal receive and 
transmit speed, the fifth and sixth are the tty modes for the login com¬ 
mand and the normal shell mode. The entries must be separated by a ’ ’ 
or tab character, the tty modes by a character. The meaning of the 
modes is as follows (see also tty (4)): 


B0 

BS0 

DA 

ALLDELAY 

B1 

BS1 

DC 

CRDELAY 

CB 

CBREAK 

DB 

BSDELAY 

CM 

CRMOD 

DN 

NLDELAY 

CR0 

CR0 

DT 

TBDELAY 

CRl 

CRl 

DV 

VTDELAY 

CR2 

CR2 

NO 

NL0 

CR3 

CR3 

Nl 

NL1 

PA 

ANYP 

N2 

NL2 

PE 

EVENP 

N3 

NL3 

PO 

ODDP 

EC 

ECHO 

TO 

TAB0 

TD 

TANDEM 

Tl 

TABl 

TX 

XTABS 

T2 

TAB2 

LC 

LCASE 

F0 

FF0 

FI 

FF1 

RW 

RAW 

HU 

HPCL 


When getty writes the ’<node name> login:’ greeting message to your ter¬ 
minal, answer with your user login name. 

The user’s name is terminated by a new-line or carriage-return charac¬ 
ter. In the second case CRMOD mode is set (see iocf£(2)). 

The name is scanned to see if it contains any lower-case alphabetic 
characters; if not, and if the name is nonempty, the system is told to map 
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any future upper-case characters into the corresponding lower-case 
characters (Then \A is mapped to upper-case A). 

Login is called with the user’s name as argument. 

FILES 

/etc/ttys 

/etc/ttytype 

/etc/termcap 

SEE ALSO 

init(8), login(l), ioctl(2), ttys(5), termcap (5), tty (4) 
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■E ALSO 

fstab(5), fs(5), crash(8), reboot(8) 


BUGS 


Inode numbers for . and .. in each directory should be checked Tor validity, 
-g and -b options from check should be available in fxk. 

There should be some way to start a fsck -p at pass n. 


t 
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